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ABSTRACT 

This  study  discusses  briefly  the  history  of  technical  figure  illustration  in  the 
Computer  Science  Department  of  the  Naval  Postgraduate  School.  The  single 
system  experiencing  the  most  usage  is  the  fully  automated  interactive  graphics 
figure  illustrator— OZDR AW.  During  its  short  and  active  life,  the  need  for 
perfective  maintenance  to  include  generalized  documentation  has  been  recognized. 
The  result  is  a  technical  graphics  figure  illustrator  with  an  improved  user  interface 
titled  NPSDRAW  and  supporting  documentation. 
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I.  INTRODUCTION 


A.  A  NEED  FOR  AUTOMATED  FIGURE  ILLUSTRATORS 

In  academic  environments,  graphical  figures  must  be  made  available  within  a 
period  of  time  equal  to  that  of  the  time  to  complete  the  text.  As  word  processors 
gain  speed  and  can  interact  with  assorted  programs  that  check  spelling, 
compute  arithmetic  values  within  text  and  even  evaluate  writing  style,  there  is 
the  need  for  a  quick  effective  means  of  providing  associated  illustrations.  The 
pressure  upon  the  illustrator  for  completion  of  his  product  is  increased  each  time 
new  software  and/or  hardware  provides  faster  output  of  a  final  text  product. 
The  only  means  by  which  the  illustrator  can  keep  pace  with  the  word  processor 
improvements  is  to  utilize  a  system  that  is  quick,  easy  to  learn,  powerful  and 
uncomplicated  to  operate  even  for  the  most  infrequent  user. 

In  the  Computer  Science  (CS)  Department  of  the  Naval  Postgraduate  School, 
the  need  for  semi- automated  or  fully  automated  illustration  systems  has  been 
served  by  a  variety  of  systems  such  as  the  PIC  Graphics  Language,  FIGURE 
Graphics  Illustrator  Program  and  most  recently.  OZDRAW,  an  interactive 
graphics  figure  illustrator.  PIC  is  a  procedural  language,  in  which  the  user 
specifies  the  motions  that  one  goes  through  drawing  a  figure.  The  language  is  the 
implementation  of  a  "semi-automated"  system,  i.e.  having  no  real-time  computer 


graphics  representation  during  the  drawing  process.  The  user  must  maintain  a 
mental  or  physical  image  of  his  proposed  drawing,  and  utilize  multiple  drawing 
commands,  variable  names  and  values,  positioning  data  and  attributes  to  provide 
the  input  ’’coded  text”  before  generation  of  his  final  product. 

FIGURE  is  a  departmentally  produced  semi-automated  system  that  produces 
an  illustration  by  using  the  users  input  of  coded  text  similar  to  that  of  PIC. 
FIGURE  requires  only  the  primitive  figure  name  and  position  to  be  drawn. 
Various  line  styles,  line  widths,  fonts  and  fill  patterns  are  simply  identified  as 
change  is  required.  The  text  then  is  processed  to  generate  the  final  product. 

OZDRAW  is  the  first  fully  automated  system  available  for  general  usage 
within  the  CS  department.  The  user  has  real-time  feedback  in  the  form  of  a 
drawing  on  a  monitor  of  a  graphics  workstation.  This  system  actually  permits  the 
user  to  do  the  actual  drawing.  The  drawing  is  then  converted  to  data  acceptable 
by  FIGURE.  OZDRAW  does  not  require  the  user  to  learn,  nor  even  be  concerned 
with  the  assignment  of  primitives,  positioning  data  or  attribute  assignment  format 
in  the  "coded  text"  file  used  by  FIGURE.  The  user  simply  draws  his  illustration 
on  the  monitor,  saves  it  to  a  file,  and  then  prints  out  that  illustration  by  invoking 


FIGURE. 


B.  SYSTEM  DRAWBACKS 

1.  PIC  Graphics  Language 

As  with  all  semi-automated  systems,  the  major  deficiency  of  PIC  is  the 
lack  of  real-time  feedback  as  the  product  is  "laid  out"  or  drawn  before  actual 
printing.  This  requires  the  user  to  have  a  detailed  sketch  or  hand  drawn 
illustration  to  work  from  and  determine  specific  numeric  values.  The  program 
then  must  be  written  to  reflect  the  sketch  and  finally  processed  for  printing. 
Though  simple  drawings  are  accomplished  somewhat  easily,  modifications  of  any 
nature  tend  to  increase  the  complexity  of  the  code.  Modification  of  figure  size, 
attributes,  positioning  data,  as  well  as,  general  picture  size  require  a  complete 
understanding  of  the  system.  PIC  is  powerful,  but  complex  and  sometimes 
difficult  even  for  experienced  users.  Furthermore,  PIC  lacks  any  capability  for  fill 
patterns. 

2.  FIGURE  Illustration  Program 

FIGURE  experiences  the  same  major  deficiency  of  all  semi-automated 
systems,  i.e.  the  lack  of  real-time  feedback.  It  was  designed  though  for  use  by 
inexperienced  and  infrequent  users.  With  each  primitive  figure’s  position  specified 
in  the  text,  simple  modifications  to  positioning,  attributes,  etc.  are  accomplished 
through  the  simple  editing  of  text.  As  an  illustration  increases  in  size  and 
complexity,  textual  change  becomes  tedious  and  difficult.  Modification  to  a  single 
figure  for  repositioning,  or  attribute  change  can  be  accomplished  with  little 
difficulty,  but  movement  of  a  block  of  figures  requires  extensive  editing  of  the 


text.  As  with  all  semi-automated  systems,  FIGURE  and  PIC  require  the  user  to 
be  knowledgeable  of  the  local  text  editor  on  the  computer  system  being  used. 
Additionally,  the  user  needs  acceptable  typing  skills  to  reduce  the  amount  of 
compiler  and  system  errors  incurred  during  processing  of  coded  text. 

3.  OZDRAW  Interactive  Graphics  Figure  Illustrator 

OZDRAW  is  a  real-time,  interactive  figure  generation  system.  It  has  been 
designed  primarily  to  run  on  the  IRIS  2400  series  of  computer  graphics 
workstations  manufactured  by  Silicon  Graphics,  Inc  of  Mountain  View, 
California.  The  output  of  the  system  is  designed  for  any  graphics  capable  laser 
printer.  The  primary  laser  printer  for  the  CS  department  is  a  Quality  Micro 
System  (QMS)  Lasergraphic  1200  . 

The  aim  of  OZDRAW  is  to  provide  a  powerful,  user-friendly  figure 
generation  system  to  enhance  the  technical  figures  required  by  the  Computer 
Science  Department  at  the  Naval  Postgraduate  School  [Ref.  l].  Since  its 
production,  OZDRAW  has  been  utilized  by  a  large  number  of  thesis  students  and 
faculty.  It  has  become  the  most  popular  figure  illustration  system  in  the 
department.  With  the  system’s  popularity,  it  has  become  apparent  that  some  of 
the  initial  design  features  are  a  hinderance  to  the  experienced  user.  Various  users 
have  expressed  a  desire  to  see  features  expanded,  as  well  as  new  capabilities  added 
to  the  original  version.  The  following  are  often  cited  areas  of  OZDRAW  design 


deficiencies: 


o  Inefficient  attribute  specification  and  display  features. 

o  Menu  organization  requires  traversal  through  numerous  levels  to  accomplish 
related  system  functions. 

o  Limited  font  specifications  /  descriptions. 

o  Lack  of  texture  representation  during  real-time  feedback  of  drawing, 
o  Insufficient  line  width  selections, 
o  Tedious  attribute  change  mechanics, 
o  Unavailability  of  common  geometric  figures, 
o  Inability  to  scale  individual  figures  and  blocks  of  figures, 
o  Lack  of  figure  alignment. 

o  Foreign  figure  data  utilization  /  conversion. 

To  date,  there  have  been  two  implementations  of  OZDRAW  put  into 
daily  use  with  the  differences  between  the  systems  being  only  in  the  method  of 
selecting  menu  options.  This  study  revolves  around  the  actual  maintenance  of 
OZDRAW  originally  written  by  Steve  Firth  in  1985/86  [Ref.  l]  and  examines  the 
addition  of  new  features  to  OZDRAW,  retitled  NPSDRAW.  These  changes  are 
compatible  with  the  OZDRAW  and  FIGURE  file  formats.  Primary  focus  of 
attention  is  on  the  overall  design  and  implementation  of  that  new  system. 


* 

A 


Illustrator".  Our  goal  was  to  provide  an  improved  user  interface  for  that  system. 
Additionally,  new  features  as  well  as  system  enhancements  were  included. 


II.  NPSDRAW:  SYSTEM  OVERVIEW 


A.  SYSTEM  CAPABILITIES 


The  program  used  as  a  basis  for  NPSDRAW  was  originally  written  by  Steve 
Firth  in  a  1985  master’s  thesis  titled  "OZDRAW  -  An  Interactive  Graphic  Figure 


1.  Primitives  Supported  by  NPSDRAW 


a 


NPSDRAW  Figure  Attributes 


Each  figure  generated  with  NPSDRAW  is  assigned  specific  attributes 
that  define  its  appearance.  The  attributes  are  for  line  width,  line  style,  texture  (fill 
pattern)  and  font.  Specific  attribute  values  available  are  dependent  on  the  current 
graphics  printer  installed.  Table  2.2  shows  the  default  settings  and  some  of 
available  settings  for  the  QMS  1200  LaserGraphic  Printer  currently  installed.  A 
complete  listing  available  attributes  with  examples  can  be  found  in  Appendix  A. 

The  IRIS  workstations  provide  only  one  predefined  font.  All  text  is 
displayed  using  that  one  font.  To  show  size  differentials  of  the  actual  font  as 
displayed  on  the  laser  printer,  NPSDRAW  generates  a  red  rectangle  around  the 
text.  This  rectangle  represents  the  actual  printed  size  of  the  character  string. 
Note:  this  rectangle  can  be  either  larger  or  smaller  than  the  text  characters 


TABLE  2.2  FIGURE  ATTRIBUTES 

FOR  NPSDRAW 

Attribute 

Default  Value 

Selections 

Line  Style 

Solid 

Solid,  Large  Dash, 

Medium  Dash,  Dotted 

Line  Width 

1  pixel  (screen),  0.01"  (printed) 

0.01"  to  0.10"  (printed) 

Texture 

Clear 

25  possible  including, 
Clear,  Solid,  Shaded, 
Horizontal,  Vertical  k 
Oblique  Lines,  and  vari¬ 
ous  patterns 

Fonts 

Roman  6-LPI,  10-CPI 

Over  100  possible:  Ro¬ 
man,  San  Serif,  Type¬ 
writer,  Slanted,  Bold, 
Special  Symbols,  with 
sizes  ranging  from  6-10 
to  8-15 

displayed.  Textures  are  accurately  shown  with  each  figure  when  drawn.  A  pallet 
of  the  available  textures  is  on  screen  at  all  times. 

3.  The  Screen  Display 

The  primary  screen  layout  of  NPSDRAW  is  shown  in  Figure  2.1. 
NPSDRAW  does  not  display  the  entire  page  but  only  a  clipped  version  (8.5"  x 
8.5")  of  the  page  at  any  one  time.  The  image  on  the  screen  is  approximately  25% 
larger  than  the  printed  image.  In  horizontal  page  alignment,  the  entire  height  is 
seen,  but  not  the  full  width.  When  in  vertical  alignment,  the  full  width  is  seen 
but  not  the  height.  The  user  can  move  about  the  page  when  in  editing  or  drawing 
functions  via  the  Arrow  (cursor)  keys  of  the  keyboard. 

Initially,  NPSDRAW  provides  a  quarter-inch  grid  overlaying  the 
drawing  area.  Discussion  of  this  grid  is  covered  in  section  B.l.  Superimposed  on 
the  drawing  area  is  a  permanent  red  dashed  rectangle.  This  rectangle  represents 
the  thesis  margins  used  at  the  Naval  Postgraduate  School.  There  are  no  limits 
though  on  where  the  user  can  draw,  even  to  the  boundaries  of  the  page. 

The  right  side  of  the  screen  provides  instructions  for  the  currently 
selected  functions.  The  current  settings  of  the  attributes  are  also  displayed  (Figure 
2.2).  Lastly  a  pallet  with  all  possible  textures  (fill  patterns)  is  maintained  for  user 
reference  and  selection  of  textures  in  changing  attributes  (Figure  2.3). 

4.  The  Printed  Page 

NPSDRAW  is  designed  to  produce  figures  for  a  standard  paper  size 
(8.5"  x  11");  the  size  cannot  be  changed.  NPSDRAW  does  allow  the  picture  to  be 


Figure  2.1  Terminal  Display  and  Drawing  Area 


Figure  2.3  Texture  (fill  pattern)  Pallet 


either  vertically  oriented  (portrait)  or  horizontally  oriented  (landscape),  i.e.  either 
8.5"  x  11"  or  11"  x  8.5"  respectively. 

5.  The  IRIS  Mouse  and  Cursor 

NPSDRAW  uses  mainly  the  mouse,  and  to  a  lesser  extent  the  keyboard, 
for  user  input.  Menu  choices  and  texture  selection  are  done  via  the  mouse.  All 
text  is  entered  via  the  keyboard.  Full  screen  movement  is  accomplished  via  the 
cursor  control  keys  (arrow  keys). 

The  IRIS  mouse  has  three  buttons  associated  with  it,  located  at  the  top 
end  of  the  mouse.  These  buttons  are  referred  in  this  manual  as  the  Left  (LM). 
Middle  (MM)  and  Right  (RM)  mouse  buttons.  The  locations  are  self- 
explanatory.  Moving  the  mouse  across  an  appropriate  surface  moves  the  position 
of  the  cursor  on  the  workstation  screen.  The  cursor  can  appear  as  a  small  red 
arrow  (menu  selections),  red  crosshairs  (texture  selection)  or  black  pencil  (drawing 
mode).  Pressing  a  button  will  perform  a  unique  operation  for  the  current 
function*.  The  function  of  each  button  is  explained  on  the  screen  at  all  times. 

B.  MENU  ORGANIZATION 

The  program  is  menu  driven  with  selections  made  through  the  use  of  the 
mouse.  The  options  in  a  menu  are  highlighted  through  movement  of  the  mouse  up 
and  down.  When  the  appropriate  selection  is  highlighted  (arrow  and  background 

*  Sometimes  when  pressed,  the  mouse  button  gives  a  "double  bounce"  i.e  it  appears  to  the 
system  and  its  user  that  the  key  has  been  pressed  more  than  once  This  occurrence  can  be  annoyine 
as  it  produces  results  that  are  not  expected  It  is  therefore  recommended  that  the  mouse  buttons 
be  pressed  in  a  crisp,  sharp  manner  to  avoid  this  situation 


color  change),  it  is  selected  by  pressing  the  middle  mouse  button  (MM). 
Throughout  the  program,  the  function  of  each  mouse  button  is  identified  on  the 
right  side  of  the  drawing  area  in  an  area  titled  KB  &  MOi’SE  BUTTON 
FUNCTIONS.  The  organization  of  the  program  is  discussed  in  the  following 
explanations  of  each  available  menu. 

1.  Main  Menu 

The  first  menu  displayed  after  start  up  and  selection  of  the  screen 
orientation  is  the  MAIN  MENU  (Figure  2.4).  There  are  16  active  options  in 
the  menu.  The  menu  should  be  thought  of  as  being  divided  into  four  functional 
areas:  Figure  Generation.  Page  Editing,  File  Storage  A  Recall  and  Attribute 
Selection. 

The  first  area  of  Figure  Generation  is  comprised  of  the  first  two  options. 
"Draw  Figures"  presents  the  user  with  the  FIGURE  MENU  (Figure  2.5)  for 
selection  of  one  of  the  available  primitives.  Lines  are  reached  through  the  second 
option  "Draw  Lines"  which  presents  the  LINE  MENU  (Figure  2.6).  Each  menu 
lists  the  various  figures  and  line  modes  possible.  The  associated  attributes  of 
those  figures  can  be  changed  from  the  same  level. 

The  second  functional  area  is  comprised  of  options  three  thru  eight  of 
the  main  menu.  These  options  concern  editing  the  page  and  specific  figures. 
SINGLE  EDIT  (Figure  2  71  and  BLOCK  EDIT  (F  igure  2.8 1  provide  the  user 
with  means  to  arrange  single  or  multiple  figures  on  the  page.  "Figure  Attribute*." 
selects  the  FIGURE  ATTRIBUTES  MENU  (Figure  2.9)  display  and  allows 


Figure  2.4  MAIN  MENU 
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the  changing  of  attributes  of  a  selected  figure.  TOGGLE  GRID  varies  the 
grid  overlay  between  a  1/4",  1/2"  and  no  overlay  on  the  drawing  area.  This  grid 
is  not  printed  on  the  final  product.  The  grid  is  displayed  in  green  with  the  1/2" 
divisions  thicker  than  the  1/4"  divisions.  ERASE  PAGE  (Figure  2.10)  clears 
the  drawing  area  and  VIEW  PAGE  permits  the  user  to  view  his  drawing  in  an 
unclipped  format  with  reduced  scale. 

The  FILE  RECALL  MENU  (Figure  2.11)  is  accessed  through  the 
"Read  File"  option.  The  "Write  File"  option  brings  up  the  FILE  STORAGE 
MENU  (Figure  2.12). 

The  last  area  of  the  main  menu  includes  the  Attribute  Change  options. 
Each  option  prompts  the  user  with  the  steps  required  to  change  the  desired 
attribute  setting.  It  is  through  these  options  that  attributes  are  set  for  figures  yet 
to  be  drawn.  The  previously  discussed  option  of  "Figure  Attributes"  allows 
changing  attributes  of  figures  already  drawn.  Finally  the  last  option  "Exit 
System",  is  the  option  used  to  terminate  the  program. 

2.  Figure  fc  Line  Menus 

The  Figure  Menu  is  obtained  through  the  selection  of  the  "Draw 
Figures"  option  of  the  Main  Menu.  This  menu  permits  the  selection  of  the 
drawing  routine  of  rectangles  (squares),  circles,  user  specified  polygons,  ellipses, 
diamonds,  triangles,  a  fixed  size  arrowhead,  and  a  seed  for  designating  a  texture 
for  a  concave  area.  The  Line  Menu  provides  the  options  of  vertical,  horizontal, 
single  (any  direction),  and  multiple  attached  straight  lines.  A  smooth  cursive 


Figure  2.9  Figure  Attribute  Display- 
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Figure  2.11  File  Read  Menu 
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style  line  and  arcs  are  also  available.  The  attributes  associated  with  the  figures 
can  also  be  set  from  these  menus.  The  "Exit”  option  returns  the  user  to  the  Main 
Menu. 

All  drawing  functions  differ  slightly  in  operation  but  are  basically 
similar.  To  begin  drawing,  press  the  middle  mouse  button  (MM).  To  finish 
drawing,  press  MM  again.  The  functions  of  the  mouse  buttons  are  always 
displayed.  All  functions  are  easy  to  use  and  most  users  are  comfortable  with  the 
drawing  process  after  several  minutes  of  experimentation.  However,  for 
completeness,  a  quick  procedural  sequence  for  each  figure  is  given  in  Table  2.3. 

3.  Single  &  Block  Edit  Menus 

The  Single  and  Block  Edit  Menus  are  the  two  interactive  editing 
facilities  of  NPSDRAW.  Single  Edit  offers  movement,  deletion,  reproduction,  or 
recovery  of  a  deleted  figure.  Selection  of  individual  figures  is  accomplished  by 
positioning  the  cursor  over  the  control  point  of  a  figure  and  pressing  the  middle 
mouse  button.  Control  points  are  corners  of  a  polygon,  centers  of  circles  and 
ellipses,  ends  of  lines  and  arcs,  and  the  beginning  of  text  strings.  If  an  object  is 
found,  NPSDRAW  will  cause  the  figure  to  blink.  The  user  confirms  the  blinking 
figure  to  be  correct  by  pressing  the  middle  mouse  button,  or  else  rejects  it  by 
pressing  either  outside  mouse  button,  After  a  figure  is  rejected,  another  figure  may 
blink  if  in  the  bounds  of  the  system’s  pick  mechanism.  Once  a  figure  is  confirmed, 
the  desired  editing  function  can  be  performed.  If  no  figure  is  found,  than  an  error 


message  is  displayed. 


TABLE  2.3  BRIEF  PROCEDURAL  DRAWING  SEQUENCES 

Rectangles 

Press  the  middle  mouse  button  to  drop  the  first  comer 
of  the  rectangle,  move  the  cursor  to  draw  the  rectangle 
and  press  the  middle  mouse  button  when  finished. 

Circles 

Press  the  middle  mouse  button  to  choose  the  center  of 
the  circle,  move  the  cursor  until  the  circle  is  drawn, 
pressing  the  middle  mouse  button  to  stop  drawing. 

Polygon 

Press  the  middle  mouse  button  to  drop  the  first  point 
of  the  polygon,  move  the  cursor  and  press  the  middle  j 

mouse  button  again  to  drop  subsequent  points.  When 
the  figure  is  complete  press  the  left  mouse  button. 

Ellipses, 

Diamonds, 

Triangles 

Press  the  middle  mouse  button  to  drop  the  first  comer 
of  a  rectangle,  and  move  the  cursor  to  draw  the 
rectangle  that  will  circumscribe  the  figure.  Press  the 
middle  button  when  finished  and  the  figure  will  be 
drawn. 

Arrow  heads 

Designate  the  position  of  the  arrowhead  tip  by  pressing 
the  middle  mouse  button  and  select  the  direction  by 
positioning  the  cursor  on  the  arrowhead  axis  behind 
the  tip.  A  dotted  line  will  appear  indicating  the  axis. 

When  in  position,  press  the  middle  mouse  button  and 
the  arrow  head  wilt  be  drawn. 

Drop  a  seed 

Select  the  position  of  the  seed  point  by  pressing  the 
middle  mouse  button.  The  area  that  encloses  the  seed 
point  will  have  the  texture  currently  set.  The  seed 
point  will  not  be  printed. 

Single  Lines 

Select  the  first  point  using  the  middle  mouse  button. 

Move  the  cursor  to  complete  the  line  and  press  the 
middle  mouse  button  to  stop.  The  vertical  or 
horisontal  line  option  restricts  line  drawing  to  the 
appropriate  direction. 

Connected  Lines 

Select  the  first  point  using  the  middle  mouse  button. 

Move  the  cursor  to  subsequent  points  and  drop  by 
pressing  the  middle  mouse  button.  When  complete, 
press  the  left  mouse  button. 

Smooth  Line 

Press  the  middle  mouse  button  to  set  the  beginning 
point.  Move  the  cursor  as  required  to  complete  the  line. 

When  complete,  press  the  middle  mouse  button. 

Arc 

Press  the  middle  mouse  button  to  choose  the  center  of 
the  arc.  Move  the  cursor  to  draw  the  circle,  pressing  the 
middle  mouse  button  when  the  correct  radius  is 
selected.  Next  press  the  middle  mouse  button  to  select 
the  start  of  the  arc.  Move  the  cursor  counter-clockwise 
and  press  the  middle  mouse  button  to  select  the  angle 
of  the  arc. 

Block  Edit  offers  movement,  deletion,  reproduction  of  two  or  more 
figures  (blocks),  movement  of  the  complete  picture  about  the  page,  and  a  block 
append  mode.  Selection  of  blocks  is  carried  out  by  the  user  drawing  a  special 
rectangle  around  the  desired  figures.  If  any  figure  has  a  control  point  within  the 
rectangle,  it  is  included  in  the  selected  edit  function. 

Movement,  deletion  and  reproduction  is  similar  to  the  single  edit 
function.  Moving  the  entire  page  is  straightforward.  The  page  is  reduced  into  an 
unclipped  image  so  that  the  user  can  see  the  page  as  a  whole.  Use  of  the  arrow 
keys  moves  the  picture  about  the  page.  This  option  is  useful  when  a  picture  is 
complete  and  requires  centering  on  the  page.  The  Block  Append  mode  permits 
reading  in  a  file  but  rather  than  immediately  fixing  the  image  to  the  drawing 
area,  it  is  attached  to  the  cursor  for  positioning  and  placement.  This  facility  is 
useful  for  special  figures  not  in  the  primitive  set. 

4.  Figure  Attributes 

The  Figure  Attributes  menu  is  acquired  by  selection  of  the  "Figure 
Attributes"  option  presented  in  either  the  Main  or  Figure  Menus.  The  user  is 
prompted  to  select  a  single  figure  via  control  points.  Once  a  figure  is  accepted,  the 
attributes  menu  appears.  Selection  of  any  attribute  from  the  menu  activates  the 
sequence  to  change  it.  Only  a  single  attribute  can  be  changed  on  a  selected  figure 
at  a  time.  If  additional  attributes  need  to  be  changed,  the  figure  must  be 
reselected.  The  presentation  of  this  menu  is  the  method  for  reviewing  the 


attributes  of  a  figure. 


5.  Clear  Screen  Menu 


There  are  two  methods  for  clearing  the  drawing  area  of  all  images.  First, 
the  user  can  remove  the  figures  through  use  of  the  single  or  block  edit  remove 
functions.  Individual  figures  can  be  recovered  at  a  later  time  in  the  same  drawing 
session.  If  complete  clearing  of  the  screen  is  necessary,  then  selection  of  the  "Erase 
Page"  option  of  the  Main  Menu  displays  the  Clear  Screen  Menu.  The  choices  on 
that  menu  are  to  "Clear  the  Screen"  or  "Continue"  drawing.  If  the  picture  is  not 
stored  before  erasure,  it  is  lost  forever.  If  the  decision  to  not  clear  is  made,  the 
user  needs  only  to  select  "Continue". 

6.  Read  &  Write  File  Menus 

To  print  a  file  or  save  a  drawing,  the  figures  need  be  stored  in  a  file. 
Naturally,  there  is  a  facility  to  retrieve  this  drawing  from  a  file.  A  directory 
listing  is  available,  listing  only  those  files  contained  in  the  user’s  current  directory. 
The  Read  and  Write  operations  are  selected  from  the  Main  Menu  and  are  similar 
in  format.  The  user  provides  a  file  name  entered  from  the  keyboard. 

If  the  user  wishes  to  read  a  file,  NPSDRAW  checks  two  conditions.  First 
it  checks  if  the  file  exists.  If  the  file  does  not  exist,  the  user  is  informed.  Second, 
the  system  checks  if  any  figures  are  displayed  on  the  screen.  If  there  are. 
NPSDRAW  asks  the  user  if  he  wishes  to  "Discard"  the  displayed  figures,  or 
"Merge"  the  two  files.  When  writing  to  a  file,  NPSDRAW  checks  if  the  file  exists. 
If  it  does  not.  it  creates  the  file  and  store  the  figures  in  it.  However,  if  the  file  does 
exist,  the  user  is  asked  if  he  wishes  to  "Append"  the  figures  to  the  end  of  the  file, 


"Overwrite”  the  contents  or  "Quit".  Overwriting  the  contents  of  a  file  destroys  its 
contents. 

7.  Line  Style  Menu 

The  Line  Style  Menu  (Figure  2.13)  is  presented  through  selection  of  the 
"Change  LineStyle"  option  from  a  menu  or  via  selection  of  changing  the  line  style 
from  the  Figure  Attributes  Menu.  The  menu  lists  four  tine  styles.  Styles 
currently  available  are  solid  (continuous)  line,  large  dashed,  medium  dashed  and 
dotted  lines.  Upon  selection  of  a  style,  the  user  is  returned  to  the  controlling 
menu.  Whenever  the  user  enters  the  Line  Style  Menu,  he  can  exit  without 
making  any  changes. 

8.  Line  Width  Menu 

The  Line  Width  Menu  (Figure  2.14)  is  presented  through  selection  of  the 
"Change  LineWidth"  option  from  a  menu  or  via  selection  of  changing  the  line 
width  from  the  Figure  Attributes  Menu.  The  menu  lists  options  of  line  widths 
from  0.01"  to  0.10",  variable  selection  and  no  change.  Variable  selection  provides 
line  widths  from  0.01  to  1.00"  in  increments  of  0.01".  Upon  selection  of  a  width, 
the  user  is  returned  to  the  controlling  menu  from  which  the  call  was  made.  The 
variable  option  operates  and  provide  line  widths  up  to  1.00"  for  NPSDRAW. 
Screen  representation  and  storage  in  memory  reflect  the  selected  size,  but  when 
printed  with  the  QMS  1200  Printer,  the  line  width  will  not  exceed  0.10". 


Figure  2 . 13  Line  Style  Menu 


HO  IN  MENU 


XIT  SYSTEM 


Figure  2.14  Line  Width  Menu  Selections 


9.  Font  Source,  Font  Style  and  Font  Sizes  Menus 


The  Font  Source  Menu  (Figure  2.15)  is  presented  through  selection  of 
the  ’’Change  Font"  option  from  a  menu  or  via  selection  of  changing  the  font  from 
the  Figure  Attributes  Menu.  This  menu  permits  selection  of  the  font  by  number, 
or  style  and  size.  The  user  can  choose  the  number  entry  method  of  font  style  as  a 
result  of  his  experience  with  OZDRAW  /  NPSDRAW,  or  he  can  select  the  font 
by  style  method  and  make  selection  by  the  style  and  size  that  suits  his  needs 
(Figure  2.16)*. 


'  Not  all  font  sizes  and  styles  are  available  See  Appendix  A  for  font  availabilny 
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III.  NPSDRAW  -  SOFTWARE  IMPLEMENTATION  DETAILS 


The  origin  of  NPSDRAW  is  as  part  of  an  M.S.  thesis  by  Steve  Firth  [Ref.  l]. 
Modification  of  that  system  began  with  improvements  to  the  user  interface. 
OZDRAW  is  a  medium  size  program,  10  -  20  K  line  of  source  code  [Ref  2],  The 
difficulty  with  the  system  lies  in  the  fact  that  the  number  of  functions  and  their 
inter-relationship  was  not  well  documented.  To  discuss  the  implementation  and 
areas  of  modification,  one  must  first  be  aware  of  the  basic  graphics  technique  of 
double  buffering  and  be  knowledgeable  of  the  data  structures  used  in  data 
manipulation.  Discussion  of  the  more  than  160  functions  is  then  clearer. 

A.  BASIC  GRAPHICS  OPERATING  SYSTEM 

Before  any  discussion  on  the  system  design  as  a  whole  can  be  accomplished, 
one  must  have  a  basic  understanding  of  the  method  by  which  the  drawn  figures 
are  presented  to  the  user.  The  smooth  "animated"  appearance  of  the  drawing  area 
is  accomplished  through  the  use  of  a  display  technique  called  Double  Buffering. 
This  technique  refers  to  the  feature  of  dividing  ail  available  bitplanes  into  two 
groups,  where  only  one  set  is  viewed  at  a  time.  Each  group  is  called  a  buffer  with 
the  visible  buffer  referred  to  as  the  Front  Buffer  and  the  non-visible  as  the 
Back  Buffer.  With  this  organization  all  writing  and  drawing  is  done  to  the  back 
buffer,  thus  alleviating  any  apparent  drawing  on  the  front  buffer.  All  drawings 


appear  "instantaneously"  to  the  user’s  eye.  unless  the  operating  system  as  a  whole 
is  slowed  down  by  either  too  large  a  drawing  or  other  background  processes.  The 
back  buffer  is  continuously  drawn  to  and  immediately  "swapped"  with  the  front 
buffer  so  that  all  screen  activity  viewed  by  the  user  is  seen  as  "smooth  &  fluid". 

B.  DATA  STRUCTURES 

Within  NPSDRAW,  there  are  two  primary  data  structures.  The  first,  object, 
is  a  computer  graphics  system  structure  to  store  the  graphics  primitives  that 
generate  a  figure.  The  second  is  a  linked  list  of  structures,  named 
drawing  struct,  that  contains  the  object,  various  parameters  for  drawing  the 
object,  numeric  information  and  pointers  to  adjacent  members  of  the  linked  list. 

1.  Object 

The  object  is  the  graphics  system’s  method  of  storing  a  particular  figure 
for  later  recall  without  the  re-execution  of  the  drawing  routines.  The  drawing 
primitives  are  stored  within  the  object.  With  a  system  call  using  the  object's 
name,  the  figure  definitions  are  retrieved  and  written  to  the  back  buffer.  In  our 
system,  the  object  does  not  contain  data  such  as  line  width,  line  style,  texture  or 
font  selection.  Each  object  can  be  redefined  to  reflect  figure  modifications.  The  use 
of  objects  permits  easy  copying  for  insertion  into  other  structures. 

2.  Drawing  Struct 

The  variable  drawing  struct  is  a  structure  in  the  C  language  analogous 
to  the  record  construct  in  PASCAL.  This  is  the  element  of  the  linked  list  which 


37 


contains  all  data  unique  to  each  figure.  As  seen  in  Table  3.1,  drawing  struct 
contains  the  figure  definition  (object),  the  figure  attributes,  numeric  information 
and  additional  pointers  to  adjacent  elements  of  the  linked  list.  Ail  this  data  is 
necessary  to  permit  the  easy  manipulation  of  single  or  group  figures,  storage  in 
files  and  subsequent  printing  of  full  page  pictures.  It  is  the  sequential  reading  of 
these  structures  in  the  linked  list  that  permit  the  continuous  drawing  of  the 
figures  to  the  back  buffer.  The  elements  of  the  linked  list  can  be  "turned  off"  from 
view  as  required  to  represent  removal,  or  can  be  designated  a  figure  on  which  a 
particular  operation  is  performed. 

C.  SOFTWARE  IMPLEMENTATION 

C  is  the  language  of  implementation  for  NPSDRAW.  All  segments  of  the 
program  are  referred  to  as  functions.  With  the  large  number  of  functions  in 
NPSDRAW,  the  best  approach  to  a  description  of  each  function  is  follow  through 
the  program  and  discuss  the  areas  using  the  organization  of  the  Main  Menu  as  a 
guide. 

1.  Initialization  and  General  Functions 

Most  functions  called  in  the  "main"  function  deal  with  the  initialization 
of  NPSDRAW  for  the  current  drawing  session.  The  call  of  main  mtnuf )  provides 
the  user  access  to  drawing  routines,  file  storage  and  recall,  and  attribute  change. 
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TABLE  3.1  COMPONENTS  OF  STRUCTURE 

"DRAWING  STRUCT" 

Component 

Type 

Explanation 

type 

short 

Records  the  TYPE  of  figure,  i.e.  CIRCLE, 
RECTANGLE,  TEXTS  etc. 

exist* 

short 

Is  the  figure  in  existence?,  i.e.  visible  on  the 
screen  or  deleted  but  recoverable. 

this  font 

short 

Font  with  which  this  figure  was  drawn. 

Used  only  with  TEXTS  but  recorded  for  all 
figures. 

this  texture 

short 

Texture  with  which  this  figure  was  drawn. 
Recorded  for  all  figures  though  all  do  not 
use  it. 

this  linestyle 

short 

Line  Style  with  which  the  figure  was  drawn. 
Recorded  for  all  figures  though  all  do  not 
use  it. 

this  linewidth 

short 

Line  Width  with  which  the  figure  was 
drawn.  Recorded  for  all  figures  though  all 
do  not  use  it. 

real  linewidth 

float 

Line  Width  with  which  the  figure  was 
drawn.  Recorded  for  all  figures  though  all 
do  not  use  it.  Line  width  read  in  can  be  of 
any  value.  NPSDRAW  maps  the  value  read 
in  to  one  of  its  own  for  presentation,  but 
stores  the  correct  value  back  out  to  the  file. 

num  info 

short 

Records  the  (a)  number  of  characters  point¬ 
ed  to  by  the  textptr  for  text  TEXTS 
figures, (b)  value  of  an  attribute  for  attri¬ 
bute  figure  and  (c)  number  of  values  point¬ 
ed  to  by  a  coord  ptr  (e.g.  DIAMOND  has  4 
pts,  thus  8  values  Ix&yj). 

figure 

object 

The  object  that  contains  the  figure  associat¬ 
ed  with  the  structure. 

textbox 

object 

An  object  containing  a  rectangle  that 
represents  the  area  occupied  by  the  TEXTS 
figure  without  text.  Used  in  page  display. 

textptr 

char 

A  pointer  to  a  text  string  for  a  TEXTS 
figure,  if  present. 

coords 

float 

A  pointer  to  coordinates  of  a  figure,  if  any. 

fwd,  bwd 

ptrs 

Pointers  to  adjacent  members  of  the  linked 
list. 

The  last  function  cleans  the  graphics  workstation  for  a  graceful  exit.  The 
functions  of  main  ()  are  as  follows: 

initialise  ()  -  undertakes  all  required  initializations  including  all  texture 
definitions,  line  style  definitions,  devices  for  queue  usage  and  initial  settings 
of  attributes.  Texture  definitions  and  attribute  settings  are  accomplished 
via  calls  to  init_textures()  and  init _attributes()  respectively.  The  actual 
means  of  setting  the  attributes  is  discussed  in  section  5. 

readfonts()  -  reads  the  current  font  table  into  memory.  The  reading  of  the 
table  occurs  each  time  the  system  is  activated,  ensuring  that  the  most 
recent  font  definitions  are  available  to  the  user  for  the  current  graphics 
printer.  As  the  table  is  read,  the  font  name,  number,  and  size 
characteristics  are  placed  in  arrays  for  future  reference. 

initpopup()  -  sets  NPSDRAW  to  accept  the  definitions  of  the  various 
menus  throughout  the  program. 

opening  display ()  -  welcomes  the  user  to  NPSDRAW  with  the  logo  of  the 
Graphics  and  Video  Laboratory. 

init  guide ()  -  the  system  inserts  the  grids  and  thesis  box  into  the  linked  list 
with  the  appropriate  alignment  acquired  from  the  user  through  a  call  of 
get  user  alignment(). 

There  are  some  general  functions  that  get  called  repeatedly  throughout 
the  NPSDRAW  system's  operation.  They  are  important  throughout  the  entire 
program.  They  are: 

display  position()  -  display  the  current  position  of  the  cursor. 

instructions()  -  display  up  to  six  lines  of  instructions  on  the  right  hand  side 
of  the  screen. 

redraw  figuresf)  -  redraw  the  current  linked  list  to  one  or  both  buffers 

set  orthoview  f)  -  set  the  correct  orthoview  with  respect  to  the  selected  page 
alignment. 


update  boundsf )  -  update  the  position  of  all  figures,  grids  and  the  thesis 
box  as  a  result  of  input  from  the  arrow  keys  on  the  keyboard.  Permits 
movement  of  the  clipped  image  of  the  page  for  work  on  areas  not  visible. 


I 


set  sereen()  -  update  the  right  hand  side  of  the  terminal  display.  Each 
attribute  setting  is  updated  at  this  time. 

newcur8or()  -  select  a  new  definition  of  the  cursor. 

get  block()  -  draw  a  block  around  a  specified  area  on  the  drawing  screen. 
This  block  is  used  to  include  figures  for  manipulation  or  represent  the  area 
in  which  a  particular  figure  is  to  be  drawn. 

full  memory()  -  checks  for  available  memory  before  reading  in  any  figures 
from  memory.  Used  in  both  "read  file"  calls. 

Though  not  a  function,  most  menus  have  an  "Exit"  option.  This  is  used  to  exit 

the  menu  when  work  is  complete. 

2.  Figure  Generation 

The  Main  Menu  can  be  viewed  as  having  four  functional  areas  of 
activity.  The  first  area  is  that  of  Figure  Generation.  That  area  includes  two  menu 
options  that  call  the  functions  fig_menu()  and  line  menu f).  Selection  of  an  option 
from  one  of  the  menus  calls  either  draw  a  (  type  figure  ),  changef  an  attribute  )  , 
or  edit  objf  CHANGE  ATTRIBUTES  ).  Each  call  to  draw  af  type  )  calls  the 
function(s)  necessary  for  that  particular  figure  to  be  drawn  as  found  in  Table  3.2. 
Each  drawing  command  contains  a  call  to  insertf)  to  store  the  figure  in  the  linked 
list.  If  a  figure  has  just  been  drawn,  calls  of  reproduce Jastf)  will  copy  the  last 
drawn  figure  and  permit  placement  anywhere  on  the  screen.  If  the  last  figure 
drawn  is  not  desired,  then  it  is  removed  with  remove  lastf).  Though  the  function 
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edit_obj(  CHANGE  ATTRIBUTES  )  is  accessible  from  figjmtnuf)  it  is  discussed  later 
in  section  3(d)  as  an  editing  function. 

3.  Editing  Functions 

The  second  functional  area  of  the  Main  Menu  is  that  of  editing  the 
screen  image.  This  includes  moving,  copying,  or  deleting  one  or  more  figures  at  a 
time,  grid  changing,  clearing  the  page  or  viewing  the  page  as  am  unclipped  image, 
a.  Single  Edit 

Single  Edit  functions  edit  only  one  figure  at  a  time.  A  figure  is 
selected  from  those  visible  on  the  drawing  area  by  find  figurtf)  and  returns  a 
pointer  to  the  structure  containing  that  figure.  A  call  on  find  figurtf)  results  in  a 


TABLE  3.2  FUNCTION  CALLS 
■DRAW  A(TYPE)* 

Type  Figure 

Function  Call(s) 

RECTANGLE 

draw  rectangle() 

SEED 

insert  seed() 

CIRCLE 

draw  circ!e() 

ARROW 

draw  arTow() 

POLYGON 

draw  po!ygon() 

DIAMOND 

get  block() 
insert  diamond() 

TRIANGLE 

get  blockQ 
insert  triang!e() 

HLINE,  VLINE,  LINE 

draw  Iine() 

TEXTS 

draw  text() 

MULTI  LINE 

draw  muiti  line() 

SMOOTHLINE 

draw  smooth  !ine() 

ARC 

get  circle() 
draw  arc() 

call  to  a  chtck(  type  )  for  types  of  arc,  circle,  line  or  text.  The  pointer  then  is 
used  as  input  to  the  subsequent  calls  that  perform  the  actual  editing.  Function 
calls  of  edit_obj(  MOVE  )  permit  the  repositioning  of  any  object.  Once  the  updated 
position  is  determined  through  movement  of  the  object  on  the  screen,  the  function 
modify  object ()  is  called.  That  function  calls  a  modify  function  unique  for  each 
type  of  figure.  An  edit  mode  of  copying  is  accomplished  through  editobjf  COPY  ) 
and  performs  similarly  to  MOVE  but  makes  a  duplicate  of  the  figure  for  placement 
on  the  screen  with  duplicatef).  Deletion  and  recovery  of  deleted  objects  during  a 
drawing  session  is  performed  by  edit_obj(  REMOVE  )  and  edit  obj(  RECOVER  ). 
These  simply  change  the  "exists"  field  of  the  structure  drawing  struct  as 
required  by  the  function.  Recovery  is  then  performed  by  drawing  all  figures 
present  in  the  list  with  an  exists  field  of  NO.  Selection  of  these  figures  is 
performed  similarly  to  selection  on  the  current  visible  screen.  Upon  confirmation 
of  a  figure,  the  exists  field  is  changed  back  to  YES.  All  edit  function  calls 
immediately  set  writtenf)  to  FALSE  indicating  the  current  illustration  is  not 
saved.  This  flag  is  only  set  to  TRUE  when  the  illustration  is  saved,  i.e.  written  to 
a  file. 

b.  Block  Edit 

The  Block  Edit  option  selected  from  the  Main  Menu  performs 
operations  similar  to  those  of  Single  Edit  but  on  two  or  more  figures  as 
determined  by  the  rectangle  presented  with  a  call  to  yet  block)).  Once  the  block 
is  placed  by  the  user,  find  objects ()  traverses  the  linked  list  with  a  set  of 


coordinates  and  determines  what  if  any  figures  exists  within  the  block.  Existence 
within  the  block  is  determined  with  calls  to  gtlptinsidef),  lptjnside  ()  or 
arc  insidef),  as  appropriate  for  the  specific  figure  type.  Once  the  figure  is 
determined  to  be  within  a  block,  a  pointer  to  it  is  placed  in  a  temporary  array  for 
further  action. 

Movement  of  a  block  in  bloekeditf)  takes  the  working  array  of 
structure  pointers  and  permits  movement  over  the  drawing  area.  Once  the  block 
of  figures  are  in  the  updated  position,  each  object  undergoes  modify  object ()  for 
its  specific  type.  During  movement,  routine  draw  page  f)  is  called  to  show  the 
changing  positions  of  the  figures.  When  bloekeditf  COPY  )  is  invoked,  all  actions 
are  similar  to  those  of  MOVE  but  additionally  calls  to  draweopyf )  and  duplicate () 
are  made. 

REMOVAL  in  bloekeditf)  simply  utilizes  the  working  array  of  figures 
found  in  the  block  and  changes  their  "exists"  field  to  NO.  There  is  no  recovery  of 
figures  in  the  bloekeditf j  calls  but  each  figure  removed  in  this  mode  can  be 
recovered  through  a  single  edit  function  as  discussed  earlier. 

The  Block  Append  option  is  similar  to  the  Block  Copy  option 
discussed  previously,  but  copies  a  block  from  a  file  rather  than  the  screen.  (The 
method  of  file  identification  is  discussed  later  in  section  3(e).)  All  actions  and  calls 
parallel  the  COPY  sequence.  The  functions  used  are  bblockeditf)  to  coordinate  the 
block  append  of  figures,  bfind  objectsf)  creates  the  working  array  of  pointers  to 
the  figures  of  a  temporary  linked  list,  bmove  filef)  moves  the  new  list  of  figures 


over  the  drawing  area  as  well  as  lets  the  arrow  keys  move  the  page.  Additionally, 
it  calls  bdrawjpagef)  which  generates  the  image  of  the  new  figures  for  movement 
about  the  drawing  area.  Once  the  position  of  the  new  figures  is  set,  bmove  page() 
links  up  the  two  separate  linked  lists  into  a  single  entity. 

The  last  option  to  discuss  from  the  Block  Edit  Menu  is  that  of  page 
movement.  The  unclipped  version  of  the  page  is  presented  through  a  change  in 
the  viewport  setting  according  to  the  initial  page  alignment.  Once  this  image  is 
present,  the  figures  themselves  are  moved  about  the  screen  via  changes  in  the 
paramters  to  the  function  set  orthview  via  inputs  from  the  arrow  keys.  Once  the 
figures  are  placed  in  the  desired  position,  all  figures  in  the  linked  list  are  taken 
through  modify  objects ()  for  update  of  their  positional  data, 
c.  Grid  Change 

A  grid  overlay  that  provides  a  guide  for  figure  placement  and 
drawing  can  be  varied  with  spacing  of  1/4”,  1/2"  or  deselected  altogether.  The 
method  of  changing  the  grid  is  performed  through  a  call  to  togglef).  When 
NPSDRAW  is  activated,  the  grids  1/4"  and  1/2  "  and  the  thesis  box  are  inserted 
into  the  working  linked  list.  As  the  user  toggles  the  grid,  the  "exists"  field  of  these 
figures  are  changed  to  represent  the  desired  overlay.  The  thesis  box  is  always 
visible,  i.e.  its  structure  "exists"  field  is  always  YES.  The  change  in  the  grid  is 
made  through  the  sequential  changing  of  the  "exists"  fields  of  the  1/2"  and  1/4" 
figures.  Though  the  grid  in  the  1/4"  version  appears  as  one.  it  is  actually  made  up 
of  two  figures  from  the  linked  list,  the  1/4"  and  1/2"  grid  figures. 


d.  Figure  Attribute  Modification 

The  last  function  that  deals  with  the  actual  editing  of  figures  and 
structures,  is  the  function  edit  obj(  CHANGE  ATTRIBUTES  ).  This  function  is 
available  through  both  the  Main  and  Figure  Menus.  The  function  call  takes  a 
selected  object  from  find_figure()  and  reads  from  drawing_struct  the  attributes 
associated  with  it  via  alter  attributes().  A  menu  is  displayed  containing  those 
attributes.  The  contents  of  the  menu  items  is  determined  by  reading  the  value 
associated  with  an  attribute  for  that  figure  and  displaying  it  on  the  menu  as  text. 
The  font  text  representation  is  determined  through  use  of  the  font  number  which 
is  used  to  determine  an  array  index.  This  index  then  accesses  the  arrays  that 
contain  the  font  name,  number,  and  size  data.  The  line  width  value  is  acquired 
directly  from  the  structure  while  the  line  style  value  is  converted  to  text  through 
a  case  statement.  Texture  is  not  represented  by  text  since  it  is  visible  on  the 
screen.  All  data  then  is  placed  in  the  menu  as  options  for  change.  Selection  of  any 
menu  option  activates  the  attribute  select  function  associated  with  the  chosen 
attribute .  The  actual  attribute  selection  functions  are  discussed  in  section  3(f). 

Once  the  value  for  the  changed  attribute  is  selected, 
alter  attributesf)  selects  the  appropriate  function  of  changefontf),  changels( ), 
changelwf)  and  changetextaf).  The  operation  of  each  change  function  is  similar  so 
a  general  description  of  the  procedure  follows.  The  call  to  the  change  functions 
passes  a  pointer  to  the  figure  and  the  new  attribute  value.  The  figure  is  first 
evaluated  if  the  change  is  appropriate.  For  example,  changing  texture  of  a  line 


does  not  make  sense  so  no  change  occurs  and  the  function  is  terminated.  Two  new 
figures  are  placed  in  the  linked  list,  one  in  front  of  the  selected  figure  for  the  new 
version  and  an  attribute  figure  placed  behind  the  selected  figure  to  reset  that 
attribute  so  following  figures  are  not  effected.  Upon  completion  of  these 
operations,  the  original  figure  is  deleted  from  the  linked  list. 

4.  File  Manipulation 
a.  Read  in  a  File 

Selection  of  the  "Read  File"  option  calls  the  function  readmenuf) 
which  presents  the  user  with  a  menu  having  options  of  "Read  File"  or  "View 
Directory".  A  choice  to  read  a  file  activates  get  from  file()  which  prompts  the 
user  for  a  file  name.  While  the  user  inputs  the  name  (visible  on  the  screen  as 
typed), NPSDR AW  waits  for  the  carriage  return  character  as  a  signal  to  evaluate 
the  given  name.  If  the  filename  is  valid  one  of  two  actions  can  occur.  If  no  picture 
is  presently  on  the  screen  (flag  function  drawing  exists  ),  the  file  is  read  into  the 
linked  list  via  file2list().  This  function  calls  individual  functions  for  each  type  of 
figure  for  actual  insertion  into  the  linked  list.  Once  the  file  is  completely  read  in, 
get  from  file  ()  is  terminated.  If  an  image  does  exist  on  the  screen,  the  user  has 
three  options,  to  quit  altogether,  i.e.  to  not  read  the  file,  to  merge  the  screen 
image  with  the  file  picture,  or  to  discard  the  previous  drawing  and  keep  only  the 
file  picture.  The  user  is  provided  a  message  as  to  the  status  of  the  file  name 
provided,  i.e.  "File  Read  Correctly",  or  "File  does  not  Exist"  followed  by 
"returning  to  Menu".  The  get  from  filef)  function  also  returns  a  value  to  the 
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calling  function  that  indicates  the  status  of  the  original  read  file  call.  It  is  these 
returned  values  that  determines  the  next  function  call  by  read  menu.  If  the 
returned  value  indicated  that  the  file  existed,  and  was  read  into  the  linked  list. 
set  orthoviewf),  redraw figures!)  and  set  _screen( )  are  called  to  finish  the  process. 

Selection  of  the  menu  option  "View  Directory"  or  incorrect  input  of 
a  file  name  calls  a  set  of  directory  functions.  To  exit  this  function,  the  user  needs 
only  to  press  the  middle  mouse  button  to  get  back  to  the  "Read  Menu. 

The  method  described  above  for  reading  in  a  file  is  the  basis  for  the 
previously  described  function  block  append!).  The  associated  function  is  that  of 
bget  from  filef). 

b.  Write  File 

The  process  of  writing  a  file  to  disk  is  similar  in  format  to  reading  a 
file.  Upon  selection  of  the  "Write  File"  option  from  the  Main  Menu,  the  user  is 
presented  a  menu  with  selections  of  "Write  File"  and  "View  Directory".  The 
selection  of  "View  Directory"  selects  the  directory  functions  as  described  above 
under  Read  File. 

The  selection  of  "Write  File"  activates  the  function  go  to  filc() 
which  then  prompts  the  user  for  a  file  name.  The  file  name  is  checked  against 
present  files  in  the  current  directory.  If  the  name  has  not  been  used,  the  new  file  is 
created  and  the  data  written.  If  the  file  is  found  in  the  directory,  the  user  is  asked 
for  one  of  three  actions  -  to  "0"verwrite.  "A"ppend.  or  "Q"uit.  Each  action  is  self 

explanatory.  The  user  is  provided  with  messages  from  the  system  regarding  the 
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status  of  the  file  such  as,  "unable  to  open",  "Writing  to  file",  "Finished  Writing" 
and  "Returning  to  menu".  Upon  completion  of  a  file  write  or  the  selection  of 
"quit"  from  the  menu  level,  the  user  is  returned  to  the  Main  Menu. 

5.  Setting  Attribute  Values 

The  setting  of  the  various  attributes  is  controlled  through  numerous 
short  functions  that  utilize  graphics  system  commands  to  set  the  screen 
representation  of  the  attributes.  The  setting  of  each  attribute  is  done  through  the 
assignment  of  the  attribute  value  to  a  variable.  This  variable  is  read  each  time  a 
new  figure  is  drawn  to  the  screen  and  inserted  into  the  linked  list.  The  functions 
called  are  of  the  form  set  current  (  attribute  )  and  get  eurrentf  attribute  ). 

The  general  operation  of  each  attribute  change  involves  two  steps:  (l) 
get  the  new  attribute  value  and  (2)  assign  that  value  to  the  appropriate  variable. 
All  values  are  provided  by  the  user  through  (a)  selection  of  the  attribute 
description  from  a  menu  or  (b)  selection  of  a  texture  from  a  pallet.  The  values 
returned  from  the  attribute  select  functions  to  the  calling  routine  are  actually 
character  strings.  These  chararacter  strings  are  later  converted  to  numeric  values 
and  used  to  update  a  current  attribute  setting  or  are  used  in  the  modification  of  a 
figure's  attributes. 

a.  Font  Selection 

When  Font  change  is  selected  from  a  menu,  the  first  function 
activated  is  fontsource( )  which  returns  a  vaiue  to  signify  the  method  of  font 
selection.  The  options  for  font  selection  are  via  numeric  value  or  style  sizing.  If 


the  user  chooses  the  numeric  option,  he  need  only  enter  the  desired  font  number 
at  the  system  prompt.  NPSDRAVV  checks  the  value  against  range  limits  (0  to 
MAXFONT)  and  then  against  the  "Findex"  array  generated  during  reading  of  the 
font  table  at  system  set  up.  If  the  numeric  value  is  contained  in  this  array,  it  is 
valid  and  a  character  string  representation  of  the  value  is  returned  to  the  caller. 

The  second  option  of  selection  is  more  complex  but  results  also  in 
the  return  of  a  simple  font  number  value.  The  user  first  sees  a  menu  of  all 
available  font  styles  (names)  .  These  names  are  not  dynamically  presented,  i.e. 
they  are  hard  coded  in  the  menu  presentation,  though  easily  modified.  Upon 
selection  of  the  desired  style  or  "No  Change"  (to  save  previous  setting)  the  user 
sees  a  second  menu  of  size  combinations  from  which  the  user  makes  a  selection. 
NPSDRAW  uses  both  values  and  cross  checks  them  with  the  "Fname"  array  for 
name  availability  and  a  matching  size  in  the  CPI  &  LPI  arrays.  If  the  user 
selected  combination  is  present,  the  index  value  from  the  arrays  is  used  to 
determine  the  actual  font  number.  This  number  is  then  returned  to  the  caller  as 
a  character  string. 

b.  Texture  Selection 

Values  for  Texture  Selection  are  acquired  through  the  sel  text/)  call. 
The  user  sees  a  "Cross  Hair  Symbol"  for  a  cursor  near  the  lower  right  of  the 
screen  for  movement  over  the  various  textures  available  on  the  pallet.  Once  the 
cursor  is  placed  over  the  desired  texture,  selection  is  made  by  pressing  the  Middle 


Mouse  Button.  If  the  mouse  is  within  an  area  that  defines  a  texture,  a  character 


string  value  is  returned  to  the  caller. 

c.  Line  Style  Selection 

A  call  for  a  Line  Style  change  is  achieved  through  sel  ls()  utilizing  a 
menu  selection  of  the  four  available  line  styles.  Each  line  style  is  described 
textually  for  selection.  The  selection  is  returned  to  the  caller  for  processing  as 
needed. 

d.  Line  Width  Selection 

Line  Width  Selection  (  seljw()  )  is  similar  to  Line  Style  selection, 
but  there  are  ten  predefined  line  widths  available  for  selection  through  a  menu. 
There  are  additional  choices  of  "variable”  or  "No  Change".  A  predefined 
selection  returns  a  character  t  ring  value  to  the  caller.  The  option  of  variable  line 
width  is  also  available,  var  Jw()  gives  a  means  for  selection  of  line  widths  in 
0.01"  increments.  The  appropriate  value  is  then  returned  to  the  caller. 

6.  Exiting  The  System 

If  the  last  option  of  the  Main  Menu  is  selected,  the  decision  to  exit  or 
remain  active  is  made  as  a  result  of  the  boolean  response  to  the  function 
cheek  exitf).  This  function  checks  if  a  drawing  exists  with  drawing  exists ()  or  if 
in  fact  the  current  drawing  was  written  to  a  file  by  checking  a  static  variable 
"drawing  written  to  file".  If  no  drawing  exists  or  it  has  been  saved,  then  a 
TRUE  is  returned  to  the  main  menu.  If  the  drawing  was  not  saved,  then  the  user 
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is  prompted  with  a  menu  for  selection  of  options.  Upon  selection  of  exit,  the 
system  is  in  main( )  and  final  exiting  of  the  system  occurs  after  a  call  to  cleanupf). 


IV.  NPSDRAW  :  SOFTWARE  MAINTENANCE 


Maintenance  is  the  work  required  to  be  done  on  a  software  system  after  it  is 
placed  in  operational  use.  This  work  includes  understanding  the  existing  system, 
documenting  the  existing  system,  enhancing  the  capabilities  of  the  system, 
answering  questions  of  users,  training  users,  rewriting  and  restructuring  the 
software  and  adapting  the  system  to  a  new  environment.  All  maintenance  work 
efforts  can  be  categorized  into  three  sub-maintenance  areas:  (1)  CORRECTIVE 
MAINTENANCE  -  maintenance  performed  to  identify  and  correct  software  errors 
and  performance  deficiencies,  (2)  ADAPTIVE  MAINTENANCE  -  maintenance 
performed  to  adapt  the  system  to  changes  in  the  environment  and  (3) 
PERFECTIVE  MAINTENANCE  -  maintenance  performed  to  enhance  the 
capabilities  and  performance  of  the  system.  Regarding  OZDRAW.  maintenance 
efforts  were  of  a  perfective  nature.  Though  corrective  maintenance  was 
performed,  it  is  not  discussed  here. 

No  matter  how  well  a  software  system  meets  the  goals  for  its  design  and 
specification,  it  will  have  to  undergo  some  change  periodically  during  its  lifetime 
to  remain  responsive  to  user  needs.  In  a  study  of  various  large  software  systems. 
M.  M.  Lehman  discussed  various  laws  of  Program  Evolution  that  appeared  to 
recur  through  the  life  cycles  of  programs  [Ref.  3].  The  First  Law  of  Program 


Evolution  is  the  Law  Of  Continuing  Change  "which  expresses  a  universally 
observed  fact  that  large  programs  are  never  completed.  They  just  evolve".  With 
continuing  observations  and  research  the  the  First  Law  is  now  stated  as: 

A  program  that  is  used  and  that  as  an  implementation  of  its  specification 
reflects  some  other  reality,  undergoes  continual  change  or  becomes 
progressively  less  useful.  [Ref  3.] 

Though  OZDRAW  is  not  a  large  system,  it  still  must  evolve  to  respond  to  the 
user’s  needs  through  maintenance.  The  final  product  of  this  maintenance  effort  is 
NPSDRAW. 


A.  MAINTENANCE  FACTORS 


Every  software  product  has  characteristics  that  either  decrease  or  increase  the 
maintenance  effort.  A  partial  grouping  of  these  is  contain  in  Table  4.1.  Those 
characteristics  pertinent  to  the  OZDRAW  system  are  program  complexity, 
number  of  user  reports,  poor  documentation,  good  initial  design  and  lack  of 
experienced  maintenance  individuals. 


TABLE  4.1  SYSTEM  CHARACTERISTICS  THAT  INFLUENCE 
THE  MAINTENANCE  EFFORT 


Increase  Maintenance  Effort 

System  Age 
System  Size 
Program  Complexity 
Number  of  User  Reports 
Application  Type 
Poor  Documentation 


Decrease  Maintenance  Effort 

Good  Initial  Design 
Modern  Software  Practices 
Automated  Tools 

Data  Base  Management  Techniques 
Good  Data  Administration 
Good  Documentation 
Experienced  Maintenance  Personnel 


To  improve  the  maintenance  effort  of  NPSDRAW  in  the  future,  there  are 
only  two  characteristics  that  can  be  dealt  with  at  the  present:  documentation  and 
a  log  of  user  reports.  There  can  be  no  change  to  program  complexity  or 
improvement  on  the  initial  design,  since  these  factors  are  set  with  the  initial 
version  of  the  system.  The  experience  of  the  personnel  who  will  perform 
maintenance  in  the  future  is  variable  and  most  likely  to  be  influenced  by  their 
expertise  in  the  C  programming  language. 

B.  IMPROVEMENT  OF  DOCUMENTATION 

Maintenance  depends  on  information  about  the  system,  from  design  through 
actual  coding.  Information  must  be  recorded  that  provides  reasons  and 
justifications  for  each  design  decision  and  modification.  Information  must  not  be 
lost  during  the  life  of  a  system.  Information  can  only  be  maintained  through 
quality  documentation. 

Many  situations  exist  where  the  quality  of  documentation  can  be  improved  as 
maintenance  is  performed.  Documentation  can  be  developed  and  maintained  with 
simple  prologues  at  the  beginning  of  a  function.  Data  would  consist  of  author's 
name,  date,  input,  output,  side  effect,  and  exceptions  if  any. 

The  quality  and  careful  design  of  code  is  also  a  part  of  a  well  documented 
system.  A  standard  and  straightforward  coding  style  should  be  be  presented  to 
maintenance  personnel  and  enforced  by  management.  In  the  academic 
environment,  students  generally  code  in  a  style  rhat  is  similar  to  their  peers,  but 


minor  variations  of  style  can  have  a  disrupting  and  possibly  confusing  effect  on 
subsequent  personnel.  The  maintenance  personnel  must  have  documentation  that 
can  be  easily  read  and  understood  sufficiently  in  order  to  maintain  the  system.  As 
documentation  improves,  the  program  will  be  easier  to  maintain  in  the  future. 
An  additional  argument  for  good  quality  documentation  is  that  maintenance 
personnel  prefer  using  embedded,  "on  line”  documentation.  As  such,  if  the  "off 
line"  documentation  is  weak  in  any  area,  he  will  tend  to  disregard  all  further 
documentation.  Simple  and  useful  forms  of  documentation  "off  line"  are  plain 
language  explanations  of  functions  and  call  hierarchy  diagrams.  Cross  reference 
listings  of  files  and  functions  are  also  useful  when  tracing  a  program  and 
understanding  its  call  hierarchy.  A  table  listing  indicating  the  callers  and  the 
functions  called  by  a  function  can  be  found  in  Appendix  B. 

C.  PHYSICAL  DIFFERENCES  NPSDRAW  /  OZDRAW 

The  process  of  improving  the  user  interface  of  the  interactive  graphics 
illustrator  has  brought  about  numerous  differences  between  NPSDRAW  and  its 
predecessor  OZDRAW.  These  changes  are  discussed  in  Chapter  V.  Some  basic 
comparisons  may  be  of  interest  at  this  time. 

OZDRAW  was  a  system  of  139  files  (165  functions).  NPSDRAW  has  133  files 
and  (189  functions).  The  difference  in  file  count  is  the  result  of  condensing 
functions  into  common  files.  Though  there  are  a  number  of  new  functions,  the 
actual  code  organization  has  been  changed  slightly.  The  actual  line  count  has 


decreased  almost  3%.  This  is  not  significant  though  and  attributed  to  difference  in 
coding  style  primarily  for  ease  of  changing  repetitious  parameters.  Actual 
increase  in  compiled  code  was  a  little  over  9%,  which  is  not  significant  for  the 
improved  interface  features. 

Overall,  the  difference  between  OZDRAW  and  NPSDRAW  source  codes  is 
primarily  minor  organizational  changes  and  additional  functions.  Future 
maintenance  will  not  be  hindered  by  an  increase  in  the  system  complexity  over 


the  original  version. 


V.  CONCLUSIONS 


A.  IMPROVED  USER  INTERFACE 

NPSDRAW  follows  the  format  of  its  predecessor  OZDRAW.  If  the  user  is 
experienced  with  OZDRAW,  he  will  notice  the  close  similarity  with  NPSDRAW, 
and  will  notice  numerous  improvements  to  the  user  interface. 

1.  Menu  Presentation  &  Composition 

The  menu  system  now  is  faster  to  traverse  and  perform  related  functions. 
Generally  the  user  is  in  the  second  level  of  menus,  whereas  OZDRAW  required 
the  user  to  move  between  the  third  and  first  level  for  most  related  functions.  The 
user  can  now  access  some  functions  from  multiple  locations  within  the  menu 
structure  rather  than  at  a  single  location. 

2.  Attribute  Display  Area 

The  current  settings  for  the  attributes  line  style,  line  width,  font  and 
texture  are  visible  to  the  user  at  all  times.  Attributes  are  no  longer  identified  by 
an  integer,  but  are  represented  numerically  (line  width,  font),  graphically  (line 
width,  line  style  A  texture)  and  textuallv  (font). 

3.  Font  Selection 

There  are  more  than  100  different  characters,  and  special  symbol  font 
definitions  available  to  the  user.  These  are  selectable  via  their  numeric  designation 
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or  through  menu  selection  of  style  and  size  specifications.  The  selected  font  is 
displayed  by  name,  number  and  size  (CPI  and  LPI)  in  the  Attribute  Display  Area 
and  for  the  individual  figure  attributes  when  required.  As  new  font  definitions 
become  available,  simple  modification  to  a  font  table  provides  immediate  update 
to  the  system  as  the  font  table  is  read  for  each  activation  of  NPSDRAW. 

4.  Texture  Representation  &  Selection 

NPSDRAW  provides  the  user  with  a  representation  of  the  selected  fill 
pattern  (texture)  as  the  individual  figures  are  drawn  (where  appropriate). 
Additionally,  the  25  different  patterns  are  displayed  in  a  pallet  format  for  easy 
selection.  The  user  no  longer  needs  to  remember  a  unique  numeric  value  for  any 
pattern.  Once  a  pattern  is  selected,  it  is  displayed  as  the  current  setting  in  the 
Attribute  Display  Area.  Screen  representations  are  unlimited,  selections  are 
limited  by  the  printer  utilized  in  drawing  the  final  illustration. 

5.  Line  Style  and  Line  Width  Representation  fc  Selection 

The  current  line  style  and  line  width  selections  are  displayed  attribute 
settings  in  the  Attribute  Display  Area.  The  line  styles  remain  the  same  (limited 
by  the  printer)  but  line  widths  are  selectable  from  0.01  to  0.1  in.  Line  width  on 
the  screen  is  proportional  to  the  grid  dimensions  while  the  numeric  value  shown  is 
the  size  of  the  printed  line.  The  current  line  style  is  displayed  within  the 
Attribute  Display  Area.  The  line  widths  are  selected  from  a  menu  containing 
preset  values  and  as  the  capability  of  the  printer  changes,  a  variable  scale 
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selection  is  provided  for  selection  of  widths  0.10  to  1.00  inches.  Line  styles  are 
textually  listed  for  selection. 

6.  Figure  Attribute  Change 

A  figure’s  attributes  can  be  changed  from  the  Main  or  Figure  Menu.  The 
selected  figure’s  attributes  are  presented  in  a  menu  for  viewing  or  selection  of 
change.  A  particular  attribute  change  can  selected  in  the  same  manner  as  current 
settings  are  selected. 

7.  Geometric  Figures  Available 

Though  all  geometric  figures  were  available  through  various  drawing 
primitives  in  OZDRAW,  two  of  the  more  common  figures,  the  DIAMOND  and 
TRIANGLE,  were  added  to  its  predefined  figures.  Previously,  the  polygon 
function  or  single  line  functions  were  used  to  construct  these.  They  are  now 
available  as  primitives. 

8.  Smooth  Line  Generation 

Within  the  Line  Menu,  a  facility  for  drawing  a  free  form  line  has  been 
added.  This  facility  provides  the  capability  for  enhancing  drawings  with  smooth 
curved  lines  or  cursive  writing  formats. 

B.  NPSDRAW  LIMITATIONS 

1.  Font  Representation 

The  IRIS  has  the  limitation  of  only  a  single  font  displayable  on  the 
terminal  monitor.  This  font  has  t.he  style  of  San  Serif  and  approximate  sizing  of  6 


LPI  and  10  CPI.  As  the  user  selects  different  styles  and  sizes,  the  characters  on 
the  screen  remain  the  same.  Even  with  the  proportioned  red  box  surrounding  the 
text,  this  becomes  annoying  and  somewhat  messy  as  the  complexity  and  amount 
of  text  in  the  picture  increases. 

A  related  font  problem  is  the  representation  on  the  screen  of  the  special 
symbols  available  with  numerous  font  selections.  The  special  symbols  must  be 
displayed  on  the  picture  as  standard  keyboard  characters  and  symbols.  Utilizing 
the  special  symbols  requires  the  user  to  have  a  "translation  table"  at  hand  when 
entering  text  onto  the  picture.  At  present,  the  final  picture  can  only  be  "proofed" 
through  review  of  a  printed  image. 

2.  Scaling 

As  with  any  drawing  process,  it  is  easier  to  draw  a  figure  in  a  larger 
format  where  slight  errors  of  alignment  are  harder  to  notice.  Special  figures  may 
be  needed  in  various  sizes  for  placement  on  different  pictures.  A  facility  to  permit 
the  scaling  of  individual  or  groups  of  figures  (blocks)  would  provide  a  greater 
flexibility  in  drawing  a  high  quality  picture.  Details  in  a  large  figure  need  to  be 
maintained  as  the  figure  is  reduced.  A  single  drawing  of  a  special  figure  could 
then  be  kept  in  the  user's  library. 

3.  Alignment 

Consistency  of  figure  size  between  similar  figures  is  easily  maintained  by 
duplication  of  the  first,  either  through  the  copy  utility  immediately  after  being 
drawn  or  through  the  utilities  in  single  or  block  edit  modes.  The  problem  that 


arises  is  the  positioning  of  these  figures  with  reference  to  a  particular  plane  or 
point  on  the  page.  Each  figure  can  be  positioned  if  the  user  moves  the  mouse 
slowly.  Proximity  of  the  figure  with  others  determines  the  visible  accuracy  of  the 
alignment  process. 

A  related  problem  is  the  placement  of  line  end  points  and  arrowhead 
positioning  at  a  specified  boundary.  Dependent  on  the  line  widths  and  styles  of 
the  figures  and  lines,  precise  setting  of  the  end  points  of  a  line,  or  the  position  of 
an  arrowhead  becomes  difficult. 

4.  Text  Placement 

As  the  user  types  in  a  text  string,  it  is  placed  on  the  picture  in  a  left  to 
right  fashion.  For  any  picture,  the  text  can  only  be  placed  horizontally,  depending 
on  the  selection  of  landscape  or  portrait  page  orientation.  The  user  therefore 
cannot  draw  a  picture  in  the  landscape  mode  and  have  the  page  number  placed  in 
a  portrait  orientation. 

Multiple  lines  of  text  cannot  be  generated  automatically  with  the  line 
feed  and  carriage  return  actions.  Each  line  must  be  placed  by  the  user,  with  the 
exactness  of  placement  left  up  to  his  experience.  The  provision  of  the  ability  to 
automatically  place  text  would  provide  a  level  of  quality  for  more  textual  oriented 


figure  displays. 


C.  AREAS  FOR  FUTURE  MODIFICATION 


As  with  all  systems,  there  can  always  be  improvements  or  enhancements  to 
maintain  their  usefulness.  For  local  usage  by  students,  faculty  and  staff, 
NPSDRAW  is  more  than  sufficient  at  this  time.  Demand  will  require  that  it  be 
modified  further  to  maintain  competence  with  commercially  available  systems. 
Below  are  listed  various  areas  for  future  research  and  modification. 

1.  Scaling 

When  a  user  designs  a  custom  figure  for  a  project,  he  undoubtedly 
desires  to  use  that  figure  at  a  later  date.  Just  the  fact  that  it  is  a  special  figure, 
means  that  it  has  more  than  a  single  primitive  component  in  it.  This  gives  rise  to 
the  need  for  a  "Block  Scaling"  option  in  the  system.  With  this  feature  available, 
the  user  could  draw  an  original  figure,  and  refine  each  component  as  the  overall 
picture  takes  shape.  This  would  make  the  system  perform  as  a  drawing  "in 
pencil"  available  for  simple  modifications  rather  than  "in  ink"  where  each  figure 
would  need  erasure  before  change  in  size. 

2.  Rotation 

Along  with  scaling  features,  a  feature  to  permit  rotation  of  figures  would 
be  a  nice  addition.  Presently,  using  primitives  built,  into  the  system,  the  user  can 
draw  most  figures  required  with  little  difficulty.  But  positioning  of  those  figures 
requires  a  sketch  of  the  picture  beforehand  to  derive  the  general  positions  on  the 
drawing  page.  Furthermore,  the  user  draws  two-dimensional  images. 
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Though  simple  three-dimensional  drawing  is  not  altogether  difficult.  NPSDRAW 
would  be  enhanced  and  simplified  even  more  so  with  a  rotation  capability. 

3.  Fixed  Point  Drawing 

"Fixed  Point  Drawing"  is  used  here  to  describe  drawing  of  figures  that 
are  centered  on  or  have  a  predefined  common  point.  Additionally  it  may  include 
restrictions  on  the  drawing  area  defined  by  the  user  during  drawing  of  sequential 
figures.  It  would  be  a  multi-function  facility.  Functions  available  could  be  (1)  the 
user  defines  a  point  that  is  common  to  selected  figures,  such  as  a  set  of  concentric 
circles.  (2)  A  limit  could  be  set  dynamically  on  the  cursor  preventing  movement 
outside  a  specified  area,  implemented  in  similar  manner  as  the  vertical  and 
horizontal  line  drawing  restriction. 

4.  Insertion  of  a  Bitmap  Image 

A  bitmap  image  insertion  capability  is  a  necessary  addition.  There  are 
images  that  one  cannot  make  on  NPSDRAW,  i.e.  figures,  that  can  be  generated 
and  copied  from  a  graphics  terminal  via  a  bitmap  dump.  The  ability  to  include 
such  a  picture  on  the  drawing  area  where  the  user  can  annotate  specific  points 
would  provide  a  high  quality  product  that  currently  can  only  be  acquired  through 
a  strictly  manual  figure  illustration  system. 

5.  Point  Modification 

As  the  user  develops  his  skill  with  NPSDRAW,  he  begins  to  make  more 
complicated  figures  to  meet  his  needs.  In  the  course  of  drawing,  some  figures 
require  the  modification  of  a  specific  point  of  a  figure,  i.e..  the  corner  of  a  polygon 


or  the  end  point  of  a  line  segment.  The  current  method  is  to  erase  the  current 
figure  and  redraw  it  as  necessary.  If  the  user  could  have  the  ability  to  move  a 
single  point  of  a  figure,  the  modifications  could  be  done  in  a  relatively  short  time 
as  compared  to  redrawing  the  complete  figure. 

D.  CONCLUSION 

NPSDRAW  was  designed  to  be  a  system  accessible  by  unskilled  users  who 
needed  a  quick,  easy  method  for  generating  illustrations.  The  system  is  intuitive 
in  its  operation.  It  still  produces  a  high  quality  product  that  can  be  easily 
modified  and  reproduced.  The  NPSDRAW  system  is  considered  a  medium  sized 
program  (at  less  than  15000  lines)  and  thus  easily  accepts  system  modification 
and  performance  enhancement.  The  limitations  and  future  modifications 
discussed  above  are  by  no  means  conclusive.  As  NPSDRAW’s  users  community 
grows,  so  do  we  expect  demands  for  the  program’s  expansion  and  modification. 
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APPENDIX  A 


NPSDRAW  WITH  THE  QMS  1200  LASER  GRAPHIC  PRINTER 

This  supplement  to  the  NPSDRAW  users  manual  is  provided  to  illustrate  the 
various  attributes  available  with  the  QMS  Laser  Printer,  and  to  identify  system 
peculiarities. 

Attributes 

NPSDRAW  uses  the  following  attributes  available  on  the  QMS  laser  printer: 

(1)  Four  linestyles, 

(2)  Ten  linewidths, 

(3)  25  textures  (fill  patterns)  and 

(4)  111  fonts. 

An  example  of  each  attribute  is  shown  later  in  this  supplement.  When  using 
various  combinations  of  attributes  and  primitives,  unexpected  results  appear  on 
the  drawing  area  and  the  printed  page.  When  drawing  circles  or  ellipses  with 
other  than  a  solid  line,  the  image  will  not  appear  on  the  screen  until  the  radius 
and  minor  axis  exceed  1.25"  for  large  dashed  lines.  1.0"  for  medium  dashed  lines 
and  0.5"  for  the  dotted  lines.  If  a  primitive  is  drawn  under  such  conditions,  only 
through  actual  printing  of  the  product  can  it  be  seen.  Though  the  image  is 
present  on  the  screen,  the  large  linewidths  imposed  on  the  broken  line  will  render 
a  printed  image  with  a  "scalloped"  edge.  Examples  of  this  aberration  are  shown 
with  the  various  linewidths  and  styles  in  this  appendix. 

OZPRINT 

The  utility  for  printing  the  NPSDRAW  figure  files  is  OZPRINT.  This  print 
program  is  a  driver  for  the  FIGURE  illustration  system.  OZPRINT  parses  the 
parameters  and  spawn  the  background  process  to  print  the  picture. 

The  method  to  print  a  file  produced  by  NPSDRAW  is  to  issue  the  following 
command: 

ozprint  -alignment  filename  [-alignment  filename' 

where  alignment  is  'h'  for  horizontal  ( landscape |  and  V  is  for  vertical  (portrait). 
More  than  one  file  can  be  printed  in  this  manner,  as  long  as  the  correct  number 
of  alignment  values  are  placed  in  the  appropriate  positions. 


A  source  of  error  is  calling  OZPRINT  twice,  or  more,  in  rapid  succession.  This 
error  is  caused  by  FIGURE  using  a  scratch  file  to  store  intermediate  data.  With 
more  than  one  process  executing  at  a  time,  collisions  over  this  scratch  file  may 
occur.  To  avoid  this,  wait  between  calls  to  print  OZDRAW  figures.  This  potential 
trouble  area  can  be  avoided  with  a  compound  call  to  the  OZPRINT  utility. 

Calling  OZPRINT  with  the  incorrect  page  alignment  for  the  current  file,  can 
produce  unexpected  results,  especially  if  the  picture  extends  beyond  the  page 
boundaries  in  a  particular  orientation.  Page  orientation  is  not5  encoded  in  the  file. 

The  Seed  Point 

When  a  seed  point  is  dropped,  it  will  fill  the  enclosed  area  with  the  currently 
set  texture.  If  the  area  is  not  enclosed,  it  will  fill  to  the  page  boundary.  The  seed 
point  will  not  be  printed. 


Drawing  a  Filled  Figure 

When  assigning  a  texture  to  a  figure  there  are  considerations  to  be  made:  (1) 
Due  to  the  polygon  fill  algorithm  used  in  OZPRINT.  only  a  concave  figure  can  be 
filled.  The  fill  pattern  is  unpredectable  when  there  are  overlapping  figures  with 
differnet  textures  and  neither  being  clear.  Attempts  to  fill  a  polygon  with  a 
segment  of  concave  border  can  also  induce  undesirable  results.  (2)  Filling  a  figure 
with  other  than  a  solid  boundary,  will  extend  the  texture  beyond  the  boundary  to 
the  next  solid  boundary  or  edge  of  the  page.  (3)  Overlapping  figures  with  other 
than  identical  textures,  will  only  be  filled  with  a  single  texture. 

Picture  Overrun 

OZDRAW  does  not  perform  any  clipping  of  figures  that  extend  beyond  the 
page  boundary.  This  is  important  to  consider  since  figures  can  be  inadvertently 
moved  off  the  page  and  stored  in  a  file.  Printing  such  images  produces  undesirable 
results.  The  printing  system  will  accept  the  files  with  errors.  The  QMS  will  handle 
overrun  to  the  right  and  top  of  the  page,  but  cannot  control  the  left  or  bottom 
margins. 
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APPENDIX  B 


FUNCTION  &  FILE  REFERENCE 
The  following  pages  are  provided  for  easy  reference  of  each  file,  its  functions 
and  general  operation  as  well  as  the  location  of  each  function.  The  functions  listed 
are  only  those  written  for  NPSDRAW,  i.e.  does  not  include  any  system  functions. 
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1.  FUNCTION  TO  FILE  CROSS  REFERENCE 


unction  Name 


lpt  inside. c  one  pt  inside 


get  user  alignment 


ter  attributes 


get  angle 


raw  arc 


arctofileQ 

arc21ist() 

barc21ist() 


blockeditQ  bblock- 
edit() 

movepicked  objs() 
bmove_file() 
draw  page  () 
bd  raw  page  () 
find  objects  () 
bfind_objects()  copy- 
block  ()  draw  copy() 


unctions 


peration 


To  view  a  certain  type  of  figure  that  is 
uniquely  defined  by  one  point,  and  to 
see  if  it  lies  inside  a  given  rectangle. 


To  prompt  the  user  for  page  alignment. 


To  get  the  users  values  to  change  and 
call  the  appropriate  functions. 


To  calculate  the  angle  that  the  second 
point  makes  with  the  first  point  and  the 
horizontal.  Used  in  drawing  arcs. 


To  draw  an  arc  and  insert  it  into  the 
list. 


(1)  To  write  the  arc  definition  to  a  file, 

(2)  to  read  an  arc  definition  from  a  file 
into  the  working  linked  list  and  (3)  to 
read  an  arc  definition  from  a  file  into  a 
temporary  linked  list  for  block  append. 


To  determine  if  a  given  arc  is  inside  a 
given  rectangle. 


o  draw  an  arrow 


To  inform  the  user  that  there  is  bad 
data  in  the  file  being  read  in. 


To  read  a  file  and  insert  the  drawing  in 
the  temporary  block  linked  list  used  in 
block  append. 


To  insert  the  figure,  with  its  associated 
data  into  the  block  linked  list. 


Functions  used  in  Move  a  Block,  Copy 
a  block  and  Block  Append. 


To  manage  the  values  that  allow  the 
page  to  be  moved  up  and  down,  or 
across.  These  values  represent  the  bot¬ 
tom  or  left  values  of  the  ortho  call. 


The  driver  function  for  block  append  - 
read  a  drawing  in  from  file  and  attach 
to  cursor  for  positioning. 


changefont 


changels 


changetexta.c  I  changetexta 


clean  mt.c 


correct. c 


cursor.c 


circle_to_file 

circle21ist() 

bcircle21ist() 


init  attributes!) 
set  real linewidthQ 
getreallinewidthQ 
set_current_linewidth() 
get_current_linewidth() 
set_current_texture() 
get  current  textureQ 
set  current  _font( ) 
get  _current_font() 
set  current  JinestyleQ 
get  current  linestyle() 


newcursor 


peration 


To  input  new  values  for  the  current  set 
attributes 


To  alter  the  font  of  a  chosen  text  string. 


To  alter  the  linestyle  of  a  chosen  figure. 


To  alter  the  hnewidth  of  a  chosen 
figure. 


To  alter  the  texture  of  a  chosen  figure. 


Determines  whether  a  chosen  point  is 
near  the  control  point  of  a  figure. 


To  draw  a  circle  given  a  start  point  and 
insert  it  into  the  linked  list. 


(1)  Writes  a  circle  definition  to  a  file  (2) 
writes  a  circle  definition  into  the  work¬ 
ing  linked  list  and  (3)  writes  a  circle 
definition  into  a  temporary  linked  list 
for  block  append. 


Removes  attributes  from  the  list  that 
are  unused. 


To  exit  the  system  and  reset  all  values. 


Reset  the  list  so  no  user  drawings  exist. 


Copy  the  last  figure  in  the  linked  list 


To  move  the  picked  figure  to  the  re¬ 
quired  position  to  copy  it. 


To  check  that  the  chosen  figure  is  in 
fact  the  figure  that  the  user  intended  to 
pick. 


These  functions  manage  the  variables 
that  are  the  current  state  of  the  attri¬ 
butes. 


Changes  the  cursor  definition  and  turns 
on  the  new  cursor. 


bwwb— — owfwwwnyTwpri  inmwiuuyym»Jiuiimwwwwtfi  u»i<nmnimjvi 


File  Name 

Function  Name 

(Operation 

dirdraw.c 

dirdraw()  dir- 

scroli() 

This  subroutine  queries  the  user  to  ac¬ 
cess  an  external  file  and  load  it  into  the 

Init  global  structure.  Additional  scrol¬ 
ling  menu  added  to  the  Mike  Gaddis 
Directory  package 

display  pos.c 

display  position() 

To  display  the  position  of  the  cursor  in 
page  coords  ie  8.5x11" 

dist.c 

distance  between  () 

To  calculate  the  distance  between  two 
points. 

draw.c 

draw  a() 

The  driver  for  drawing  all  the  primi¬ 
tives  available. 

draw  erased.c 

draw  erasedQ 

To  draw  the  page  displaying  only  those 
figures  that  have  been  erased. 

duplicates 

duplicate() 

To  duplicate  the  required  figure 

edit  menu.c 

edit  menu 
block  edit() 

To  display  the  edit  or  block  edit  menu 
and  get  the  users  selection 

edit  obj  s 

edit  opj() 

To  be  the  "driver"  for  the  single  edit 
functions. 

ellipse2fnls 

ellipse  to  file() 

ellipse21ist() 

bellipse21ist() 

(1) To  write  an  ellipse  definition  to  file, 

(2)  To  read  an  ellipse  definition  from  a 
file  and  insert  into  the  working  linked 
list  and  (3)  To  read  an  ellipse  definition 
from  a  file  and  insert  into  a  temporary 
linked  list. 

exits 

check  exit() 

Check  if  the  user  wishes  to  exit  without 
saving  the  picture. 

fig  menus 

fig  menu() 

To  display  the  figure  menu  and  get  the 
user’s  selection. 

file21ists 

file21ist() 
get  next() 

To  read  a  file  and  insert  the  drawing  in 
the  working  linked  list. 

finds 

fintT  figure() 

To  find  if  a  figure  exists. 

font2fnls 

font  to  file() 

font21ist() 

bfont21ist() 

(1)  Write  the  font  value  to  a  file  (2) 
read  the  font  value  from  a  file  to  the  1 

working  list  and  (3)  read  the  font  value  \ 

from  a  file  into  the  working  temporary  j 

linked  list 

font  sices 

font  size() 

To  calculate  the  size  of  the  red  box  to 
be  placed  around  text  to  indicate  the 
different  size  of  t  he  font. 

fontsources 

fontsource() 

To  get  the  font  selection  source  from 
the  user  i.e.  by  numeric  value  or  by  j 

selection  of  style  and  size  j 

fulls 

full  memory() 

To  flag  the  user  that  he  has  filled  up  all 
available  memory.  1 

112 


W 


S0BTO96M 5 


v./.v./ 


vw 


5«KW 


&ww 


getcircle.c 


get  list  .c 


getq.c 


V 


getlist 


get  queue 


■ert  ell.c 


insert_ellipse() 

binsertellipseQ 


insert  diamond 
inserttriangleQ 


instruct. c 


instructions 


peration 


To  call  M  GADDIS‘s  directory  func¬ 
tions. 


To  get  the  coords  for  a  rectangle  that 
inscribes  an  area  for  figure  selection. 


To  get  from  the  user  a  circular  section 
of  the  screen.  The  center  point  has  al¬ 
ready  been  determined,  now  all  that  is 
needed  is  the  radius. 


Get  the  listing  for  the  directory 


Steve  Firths  idea  of  a  queue’s  operation 


It  is  the  logo  for  the  NPS  Graphics  and 
Video  Laboratory 


To  see  if  a  certain  class  of  figures  that 
has  many  points,  lies  within  a  region. 


Undertake  all  required  initialization  of 
variables  and  settings  for  NPSDRAW. 


Inserts  four  structures  into  the  working 
linked  list  that  represent  the  grids  & 
thesis  box  -  guides  on  the  drawing  area 
Initialization  of  all  possible  textures.  All 
texture  definitions  are  kept  here. 


The  driver  that  inserts  all  figures  with 
data  into  the  working  linked  list. 


Takes  all  arc  relevant  information  and 
inserts  it  into  either  the  working  linked 
list  or  the  temporary  linked  list  for 
block  append. 


Takes  all  ellipse  data  and  inserts  it  into 
the  working  linked  list  or  the  temporary 
linked  list  for  block  append. 


Takes  diamond  or  triangle  data  and  in¬ 
serts  it  into  the  working  linked  list  from 
a  drawing  sequence.  Not  used  for  file  to 
list  or  block  append  since  in  files  they 
are  referred  to  as  polygons  only. 


To  see  if  a  particular  given  point  lies 
within  a  given  rectangle.  Used  for 
selecting  "rectangle”  prompts  on  the 
screen. 


To  display  the  function  of  the  mouse 
buttons  and  keys. 


To  flag  to  the  user  that  the  entry  he  has 
entered  to  change  an  attribute  is  in¬ 
valid. 


i  air 


raw  line 


e  menu.c 


linestyle_to_file 

linestyle21ist() 

blinestyle21ist() 


w2fnl.c 


main  menu.c 


map.c 


mod  arc.c 


peration 


To  draw  a  single  line  given  the  start 
point. 


(1)  To  write  a  line  to  a  file  (2)  To  read 
a  line  definition  from  a  file  into  the 
working  linked  list  and  (3)  to  read  a 
line  definition  from  a  file  into  the  tem¬ 
porary  linked  list  for  block  append. 


To  prompt  the  user  for  the  various  lines 
that  can  be  drawn  via  a  menu  selection 


To  map  the  set  linewidth  attribute  to 
the  real  linewidth  and  map  the  chosen 
linewidth  to  a  number  of  pixels  on  the 
screen. 


The  driver  that  controls  the  storage  of 
all  existing  figures  to  the  file. 


(1)  to  write  a  line  style  to  a  file,  (2)  to 
read  a  line  style  from  a  file  into  the 
working  linked  list  and  (3)  read  a  line 
style  from  a  file  and  into  the  temporary 
linked  list  for  block  append. 


(1)  to  write  a  line  width  to  a  file,  (2)  to 
read  a  line  width  from  a  file  into  the 
working  linked  list  and  (3)  read  a  line 
width  from  a  file  and  into  the  tem¬ 
porary  linked  list  for  block  append. 


To  display  the  main  menu  and  get  the 
users  selection. 


To  map  from  page  to  screen  coords  and 
vice  versa. 


To  change  the  position  of  a  given  arc  by 
the  given  amount  without  changing  its 
attributes. 


To  move  the  chosen  circle  by  the  given 
amount. 


To  change  the  position  of  a  given  ellipse 
by  a  given  amount  without  changing  its 
attributes 


To  change  the  position  of  a  given  line 
by  a  given  amount  without  changing  its 
attributes. 


To  select  the  given  function  to  move  the 
chosen  figure. 


To  change  the  position  of  a  given  po¬ 
lygon  a  given  amount  without  changing 
its  attributes. 


not  found  .c 


poputil.c 


printable. c 


poly  to  file 
polygon21ist() 
bpolygon21ist() 
dorectangleQ 
bdo_rectangle() 
do_polygon() 
bdo  polygon 


initpopup()  pop- 
up()  showpopupQ 


readfonts.c  readfonttabie() 
index2ftable() 


rectangle.c 


remove.c 


peration 


To  change  the  position  of  a  seed 


To  change  the  position  of  a  given  text 
string  a  given  amount  without  changing 
any  of  its  attributes. 


To  move  an  object  on  the  page. 


To  reduce  the  page  so  it  can  be  seen  in 
its  entirety  and  allow  the  user  to  move 
all  the  figures  in  one  motion. 


Draw  continuous  lines  ,  i.e.  adjoined 
non  parallel  segments. 


The  driver  for  the  illustrator  system. 


To  inform  the  user  that  when  he  chose 
an  object  for  editing  the  cursor  was  not 
close  enough. 


(1)  To  write  a  polygon  definition  to  a 
file  ,  (2)  to  read  a  polygon  definition 
from  a  file  into  the  working  linked  list 
and  (3)  to  read  the  polygon  definition 
from  a  file  into  the  temporary  linked  list 
for  block  append. 


To  draw  a  polygon  given  the  start 
point. 


(1)  Initialize  the  system  for  use  of  the 
popup  menu  system,  (2)  generate  the 
menus  and  get  the  users  selection,  and 
(3)  show  the  menus. 


To  calculate  if  a  value  is  a  printable 
ASCII  character. 


The  driver  function  to  read  a  drawing  in 
from  file. 


Displays  the  read  menu  and  get  the 
users  selection. 


(1)  Read  the  font  table  and  fill  arrays 
with  the  data,  (2)  Take  a  font  number 
and  find  the  index  to  its  data  in  the  ar¬ 
ray. 


Draws  a  rectangle  given  the  start  point. 


Redraw  the  complete  picture  from 
linked  list  to  one  or  both  buffers. 


To  remove  the  last  chosen  drawn  figure, 
e.g.  remove  the  last  drawn  circle  when 
circles  are  selected  as  the  primitive  to 
be  drawn. 


text.c 


sensible. c 


set  mouse. c 


jESiSZlil 

mm 


insertjseed 
binsert_seed() 


seed_t°_file 
seed2iist() 
bseed21ist() 


w.c 

[  select  lw 

[« 

var  lw 

lEBgM 


not  sensible 


set  ortho  view 


ame.c 

se 

ename 

peration 


(1)  Insert  a  seed  into  the  working  link 
list  and  (2)  insert  a  seed  into  the  tem¬ 
porary  linked  list  for  block  append. 


(1)  To  write  the  seed  definition  from  the 
list  to  a  file,  (2)  to  write  the  seedpoint 
definition  from  a  file  into  the  working 
linked  list  and  (3)  to  write  the  seedpoint 
definition  from  a  file  into  the  temporary 
linked  list  for  block  append. 


To  get  the  user  font  selection. 


To  get  the  user  line  style  selection. 


To  get  the  user  line  width  selection. 


To  get  the  user  texture  selection. 


To  flag  to  the  user  that  he  has  tried  to 
alter  an  attribute  of  a  figure  that  does 
not  make  sense.  For  example  changing  a 
texture  of  a  text  string  would  be  useless. 


To  set  the  ortho  and  viewport  for  the 
correct  alignment  so  the  page  can  be 
drawn. 


To  display  the  filename  of  the  file  read 
in  on  the  top  right  corner  of  the  screen. 


Various  functions  to  manipulate  the 
mouse.  The  last  two  functions  are  used 
by  the  line  functions  to  force  the  mouse 
to  be  either  horizontal  or  vertical. 


To  set  up  the  right  hand  side  of  the 
screen. 


To  draw  a  smooth  continuous,  cursive 
style  line. 


To  store  and  manage  the  value  of  page 
alignment. 


To  flag  to  the  user  that  one  of  the  op¬ 
codes  read  in  from  the  file  was  not 
recognized. 


Draws  text  given  the  starting  point. 
The  headings  are  instruction  boxes  that 
appear  on  the  screen. 


rfflgn-rr— — i 

'HH 

r  Operation 

text2fnl.c 

text  to  fileQ 

text21ist() 

btext21ist() 

(l)  To  write  a  text  string  from  the 
linked  list  into  a  file  (2)  to  write  a  text 
string  from  a  file  to  the  working  linked 
list  and  (3)  to  write  a  text  string  from  a 
file  to  the  temporary  linked  list  for 
block  append. 

texture2fnl.c 

texture  to  file() 

texture21ist() 

btexture21ist() 

(1)  To  write  a  texture  value  from  the 
linked  list  into  a  file  (2)  to  write  a  tex¬ 
ture  value  from  a  file  to  the  working 
linked  list  and  (3)  to  write  a  text  value 
from  a  file  to  the  temporary  linked  list 
for  block  append. 

toggle.c 

To  toggle  the  grid  overlay  that  is 
displayed  on  the  screen. 

To  allow  the  user  to  view  the  entire 
page  unclipped  at  a  reduced  scale. 

opening  display  () 

To  display  the  opening  banner  page 
with  logo. 

widt  h21  wn  um.c 

Return  the  attribute  value  of  the  passed 
real  linewidth. 

write.c 

The  driver  function  to  write  the  draw¬ 
ing  to  a  file. 

write  menu.c 

...  -  —  .  . 

To  display  the  write  menu  and  to  get 
the  users  selection. 

2.  FILE  TO  FUNCTION  CROSS  REFERENCE 


alter  attributes  () 

aiter.c 

arc21ist() 

arc2fnl.c 

arc  insideQ 

arc  inside.c 

arc  to  file() 

arc2fnl.c 

bad  data() 

bad.c 

barc21ist() 

arc2fnl.c 

bblockedit() 

blockedit.c 

bcircle21ist() 

circle2fnl.c 

bdo  polygon() 

poly2fnl.c 

bdo  rectangle() 

poly2fnl.c 

bdraw  page() 

blockedit.c 

bellipse21ist() 

ellipse2fnl.c 

bfile21ist() 

bfile21ist.c 

bfind  objects() 

blockedit.c 

bfont21ist() 

font2fnl.c 

bget  from  file() 

bread.c 

binsert  arc() 

insert.c 

binsert  ellipse() 

insert  ell.c 

binsert  into  list() 

binsert.c 

binsert  seed() 

seed.c 

bline21ist() 

line2fnl.c 

blinestyle21ist() 

ls2fnl.c 

blinewidth21ist() 

lw2fnl.c 

block  edit() 

edit  menu.c 

blockedit() 

blockedit.c 

bmove  file() 

blockedit.c 

bpolygon21ist() 

poiy2fnl.c 

bseed21ist() 

seed2fnl.c 

btext21ist() 

text2fnl.c 

btexture21ist() 

texture2fnl.c 

change() 

change.c 

changefontQ 

changefont.c 

changels() 

changels.c 

changelw() 

changelw.c 

changetexta() 

changetexta.c 

check  1st  lw() 

clean  list.c 

check  1st  not  defaultQ 

clean  list.c 

check  arcQ 

check  figure.c 

check  circle() 

check  figure.c 

check  correct () 

correct. c 

check  exit() 

exit.c 

check  line() 

check  figure.c 

check  text() 

check  figure.c 

circle2list() 

circle2fnl.c 

circle  to  file() 

circle2fnl.c 
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Files 

clean  font() 

clean  list.c 

clean  linestyleQ 

clean  list.c 

dean  list() 

clean  list.c 

clean  textureQ 

clean  list.c 

cleanup() 

cleanup.c 

clearpage() 

clearpage.c 

copy  obj() 

copy  obj.c 

dirdrawQ 

dirdraw.c 

dirscroll() 

dirdraw.c 

display  position() 

display  pos.c 

distance  between  () 

dist.c 

do  polygon  () 

poly2fnl.c 

do  rectangleQ 

poly2fnl.c 

draw  a() 

draws 

draw  arc() 

arc.c 

draw  arrow  () 

arrow. c 

draw  circleQ 

circle.c 

draw  erased  () 

draw  erased. c 

draw  line() 

line.c 

draw  multi  line() 

multi  line.c 

draw  page(7 

blockedit.c 

draw  polygon() 

polygon.c 

draw  rectangle  () 

rectangle. c 

draw  smooth  line() 

smoothline.c() 

draw  textQ 

text.c 

duplicate() 

duplicates 

edit  menu() 

edit  menu.c 

edit  obj() 

edit  obj.c 

ellipse21ist() 

ellipse2fnl.c 

ellipse  to  file() 

ellipse2fnl.c 

fig  menu(] 

fig  menus 

file2list() 

file21ist.c 

find  figure() 

finds 

find  objects() 

blockedit.c 

font21ist() 

font2fnl.c 

font  size() 

font  sizes 

font  to  file() 

font2fnl.c 

fontsource() 

fontsource.c 

full  memory  () 

fulls 

get  alignmentQ 

store  alignments 

get  angle() 

angles 

get  block  () 

getblock.c 

get  bottomQ 

borders 

get  circle() 

getcircle.c 

Functions 

Files 

modify  arc() 

mod  arc.c 

modify  circleQ 

mod  circle.c 

modify  ellipse() 

mod  ellipse.c 

modify  line() 

mod  line.c 

modify  object() 

mod  obj.c 

modify  polygon() 

mod  poly.c 

modify  seed() 

mod  seed.c 

modify  text() 

mod  text.c 

move  obj() 

move  obj.c 

move  page() 

move  page.c 

move  picked  objs() 

blockedit.c 

newcursor() 

cursor.c 

not  found() 

not  found.c 

not  sensibie() 

sensible.c 

one  pt  insideQ 

lpt  inside. c 

opening  display () 

welcome.c 

poly  to  file() 

poly2fnl.c 

polygon21ist() 

poly2fnl.c 

popup() 

poputil.c 

printable  () 

printable. c 

read  menu() 

read  menu.c 

readfonttable() 

readfonts.c 

redraw  figures() 

redraw.c 

remove  last() 

remove.c 

replace  hdgl  w  hdg2() 

text.c 

reproduce  lastQ- 

copy  last.c 

reset  mouse  () 

set  mouse.c 

restrict  mouseQ 

set  mouse.c 

seed  to  file() 

seed2fnl.c 

seed21ist() 

seed2fnl.c 

select-text() 

sel  text.c 

select  font() 

set  font.c 

select  ls() 

sel  ls.c 

select  lw() 

sel  Iw.c 

set  alignment() 

store  alignment. c 

set  bottomQ 

border. c 

set  current  font() 

current. c 

set  current  !inestv!e() 

current. c 

set  current  linewidth() 

current.c 

set  current  texture() 

current. c 

set  filename{) 

set  fname.c 

set  mouse() 

set  mouse.c 

set  orthoview() 

set.c 

set  real  linewidthQ 

current.c 

set  screen () 

setnewscrn.c 

showpopupQ 

poputil.c 

syntax  error () 

syntax.c 

text21ist() 

text2fnl.c 

text  to  file() 

text2fnl.c 

texture21ist() 

texture2fnl.c 

texture  to  file() 

texture2fnl.c 

toggle() 

toggle  grid.c 

update  bounds() 

border.c 

var  IwO 

sel  lw.c 

view  page() 

view  page.c 

width2lwnum() 

width21wnum.c 

write  menu() 

write  menu.c 

3.  FUNCTIONS:  CALLED  FROM  &  CALLS  TO 


FUNCTIONS 

Function 

Called  From 

Calls  To 

alter  attributesQ 

edit  obj() 

changefontQ  changels() 
changelw()  changetex- 

ta()  instructions() 

select  font()  select  ls() 
select  lw()  select  text() 

arc21ist() 

file21ist() 

insert  arc() 
map  to  list() 

arc  inside() 

find  objects  () 

inside() 

arc  to  file() 

list2file() 

map() 

bad  data() 

bfile2iist()  file2iist() 

get  queue() 
redraw  figures() 
set  orthoviewQ 

barc21ist() 

bfile21ist() 

map  to  listQ 
binsert  arc() 

bblockeditQ 

block  edit() 

bfind  objectsQ 
bmove  file()  newcursor 

bcircle21ist() 

bfile21ist() 

binsert  into  list() 
map  to  list() 

bdo  polygon() 

bpolygon2list() 

binsert  into  list() 
map  to  listQ 

bdraw  page() 

bmove  file() 

get  bottomQ  get  left() 
set  orthoviewQ 

bdo  rectangle() 

bpolygon2list() 

binsert  into  listQ 

bellipse21ist() 

bfile21ist() 

binsert  into  listQ 
map  to  listQ 

bfile21ist() 

bget  from  file() 

bfile21ist()  instructionsQ 
set  current  fontQ 
set  current  linestyleQ 
set  current  linewidthQ 
set  current  textureQ 
set  real  linewidthQ 
set  writtenQ 

bfind  objects 

bblockedit() 

[none 

Function 

Called  From 

Calls  To 

bfont21ist() 

bfile21ist() 

binsert  into  list() 
set  current  font() 

bget  from_file() 

block  edit() 

bfile2list()  instructions () 
get  queue () 
set  current  font() 
set  current  linestyle() 
set  current  linewidth() 
set  current  texture() 
set  real  linewidth() 
set  writtenQ 

b insert  arc() 

barc21ist() 

binsert  into  list() 

binsert  ellipse () 

bellipse21ist() 

binsert  into  list() 

b insert  into  list() 

barc21ist() 

bcircle21ist() 

bellipse21ist() 

bfile21ist()  bfont21ist() 

binsert  seed() 

bline21ist() 

bpoly21ist() 

btext21ist() 

btexture21ist() 

font  size() 
full  memory  () 
get  current  font() 
get  current  texture() 
get  current  linestyle() 
get  current  linewidthQ 
get  real  linewidthQ 
set  writtenQ 

binsert  _seed() 

bseed21ist() 

binsert  into  listQ 

bline2list() 

bfile21ist() 

binsert21ist() 
full  memoryQ 
map  to  listQ 

blinestyle21ist() 

bfile21ist() 

binsert  to  listQ 
set  current  linestyleQ 

blinewidt  h2list  ( ) 

bfile21ist() 

binsert  to  listQ 
lw2pix() 

set  current  lineQ 
widthdth21wnum() 

h 


Function 

Called  From 

Calls  To 

blockeditQ 

block  edit() 

copyblockQ 
find  objects() 
get  blockQ 

get  bottom()  get  left() 

get  queueQ 

move  picked  objs() 

newcursorQ 

redraw  figures() 

set  orhtoview() 

update  bounds() 

bmove  file() 

bblockedit() 

bdraw  page() 
display  position() 
get  bottom()  get  left() 

get  queueQ  instruc- 

tionsQ  modify  objectQ 
update  bounds() 

bpolygon21ist() 

bfile21ist() 

bdo  rectangle  () 
bdo  polygon  () 
full  memory() 

bseed2list() 

bfile21ist() 

binsert  seedQ 
map  to  listQ 

btext2list() 

bfile21ist() 

binsert  into  listQ 
get  current  fontQ 
get  current  linestyleQ 
get  current  linewidthQ 
map  to  listQ 

btexture21ist( ) 

bfile21ist() 

binsert  into  listQ 
set  current  textureQ 

change() 

fig  menu() 
line  menuQ 
main  menu() 

insert  into  listQ 
select  fontQ  select  lsQ 
select  IwQ  select  textQ 
set  current  fontQ 
set  current  linestyleQ 
set  current  linewidthQ 
set  current  textureQ 

Function 

Called  From 

Calls  To 

changefontQ 

alter  attributesQ 

insert  into  listQ 
invalid  entry  () 
not  sensibleQ 

changels() 

alter  attributes() 

insert  into  listQ 
invalid  entryQ 
not  sensibleQ 

changelw() 

alter  attributesQ 

insert  into  listQ 
invalid  entryQ 
not  sensibleQ 

changet«xta() 

alter  attributes 

insert  into  listQ 
invalid  entryQ 
not  sensibleQ 

check  1st  not  default  () 

clean  listQ 

[none] 

check  arc() 

find  figureQ 

[none] 

check  circle() 

find  figureQ 

[none] 

check  correct  () 

find  figureQ 

draw  erasedQ  get  queueQ 
instructionsQ 
redraw  figuresQ 
set  orthoviewQ 

check  exit  () 

main  mem 

•00 

instructionsQ  newcursorQ 
popupQ  showpopupQ 

check  lineQ 

find  figureQ 

[none] 

check  text () 

find  figureQ 

[none] 

circle21ist() 

file21ist() 

insert  into  listQ 
map  to  listQ 

circle  to  file() 

Hst2file() 

mapQ 

clean  font() 

clean  listQ 

[none! 

clean  linestyle() 

clean  listQ 

[none; 

clean  linestyle() 

clean  listQ 

[none] 

clean  list() 

list2file() 

check  1st  lw() 
check  fontQ 
check  1st  not  defaultQ 
check  linestyleQ 
check  linewidthQ 
check  textureQ 

clean  font() 

clean  listQ 

[none] 

clean  texture() 

clean  listQ 

[none! 
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Function 

Called  From 

Calls  To 

cleanup  () 

getlistQ  list2file() 

main() 

[none 

clearpageQ 

main  menu() 

instructionsQ  newcur- 

sor()  popup() 

redraw  figures() 
showpopup() 
set  current  font() 
set  current  linestyleQ 
set  current  linewidth() 
set  current  textureQ 
set  filename() 
set  orthoviewQ 
set  real  linewidth() 
set  screenQ 

copyblockQ 

blockedit() 

display  position() 
draw  copy()  duplicate() 
get  bottom()  get  left() 
get  queueQ  instruc- 

tions()  set  orthoview() 
set  written() 
update  bounds() 

copy  obj() 

copy  last()  edit  obj() 

get  alignment) 
get  bottom()  get  left() 
get  queue()  instruc- 

tions()  set  orthoview() 
update  bounds 

dirdraw() 

dirscrollQ 
get  directory  () 

none 

dirscrollQ 

get  directory() 

[none1 

Function 

Called  From 

Calls  To 

display  _position( ) 

block  edit()  block- 

edit()  bmove_fileQ 

copy  obj()  copy- 

block()  draw  a() 

draw  arc() 
draw  arrow.c() 
draw  circleQ 
draw  line() 
draw  multi  line() 
draw  polygon() 
draw  rectangle  () 
draw  smooth  line() 
draw  textQ 
edit  menu()  edit  obj() 
fig  menuQ  get_block() 
get  circle() 
line  menu() 
main  menu() 
move  picked  objsQ 
not  found() 

replace  hdgl  w  hdg2() 
set  screen  () 

[none] 

distance  bet  ween  () 

draw  circleQ 
get  circleQ 

jnonej 

do  polygonQ 

polygon21ist() 

insert  into  listQ 
map  to  listQ 

insert  in to  listQ 
maptolistQ 


dorectangleQ 


polygon21istQ 


Called  From 

Calls  To 

fig  menu() 
line  menu() 
main  menu() 

display  position () 
draw  arc() 
draw  arrow  () 
draw  circie() 
draw  line() 
draw  multi  line() 
draw  polygon  () 
draw  rectangle!) 
draw  smooth  iine() 
draw  text()  get  blockQ 
get  bottom() 
get  circle()  get  left() 

get  queue() 
insert  diamond() 
insert  ellipse() 
insert  seed() 
insert  triangle!)  instruc¬ 
tions! )  newcursorf) 

remove  last() 
redraw  figures!) 
reproduce  iast() 
set  orthoview () 
update  bounds() 

draw  a() 

display  position!) 

get  left()  get  bottom!) 

get  queue()  insert  arc() 

instructions!) 

redraw  figures!) 

set  orthoview () 

Function 

Called  From 

Calls  To 

draw  arrow  ( ) 

draw  a() 

• 

display  position() 
get_left()  get  bottom() 
get  queue() 

insert  into  list()  instruc- 
tions()  redraw  figuresQ 
set  current  linestyle() 
set  current  linewidthQ 
set  current  texture() 
set  orthoview() 
set  real  linewidthQ 
update  boundsQ 

draw  circla() 

draw  a() 

get  bottom()  get  leftQ 
instructionsQ 
display  position  () 
get  queueQ 
set  orthoviewQ 
redraw  figuresQ 
update  boundsQ 
insert  into  listQ 

draw  copy() 

blockedit() 

get  bottomQ  get  leftQ 
set  orthoviewQ 

draw  crasedQ 

check  correct  () 
edit  obj() 

[NONE] 

draw  line() 

draw  a() 

get  bottomQ  get  leftQ 
get  queueQ  instruc¬ 

tionsQ  restrict  mouse Q 
set  orthoviewQ 
redraw  figuresQ 
update  boundsQ 

draw  multi  line() 

draw  a() 

get  bottomQ  get  leftQ 
get  queueQ  instruc¬ 

tionsQ  redraw  figuresQ 
set  orthoviewQ 
update  boundsQ 

Function 

Called  From 

Calls  To 

draw  pagc() 

move  picked  objs() 

get  bottom()  get  left() 
set  orthoview() 

draw  poly  gon( ) 

draw  a() 

get  bottomQ  get  left() 
get  queue() 
update  bounds() 
insert  into  list()  instruc- 
tions()  redraw  figures() 
set  orthoviewQ 

draw  rectangl«() 

draw  a() 

display  position() 
get  bottom()  get  left() 

get  queue()  instruc- 

tionsQ  insert  into  list() 
redraw  figures() 
set  orthoview() 
update  bounds() 

draw  smooth  line() 

draw  a() 

display  positionQ 
get  bottom()  get  left  ( ) 
insert  into  listQ  instruc- 
tions()  redraw  figures() 
set  orthoviewQ 
update  boundsQ 

draw  text() 

draw  a() 

display  positionQ 

get  bottomQ 

get  current  fontQ 

gel  current  linewidthQ 

get  current  linestvleQ 

get  leftQ  get  queueQ 

insert  hdgiQ 

insert  into  listQ  instruc* 

tionsQ  Iw2pix()  print- 

ableQ  redraw  figuresQ 

remove  lastQ 

replace  hdgl  w  hdg2() 

set  ortoviewQ 

update  boundsQ 

Function  Called  From  Calls  To 

duplicateQ  copyblock()  full_memory() 

copy_object()  get_current_font() 

get  current _linestyle() 
get  current JinewidthQ 
get_real_linewidth() 
get  current  textureQ 
insert_into_list() 
modify  objectQ 
set_current_font() 
set_current  Jinestyle() 
set  _current  Jinewidth() 
set_current_texture() 
set_real_linewidth() 

edit_menu()  main_menu()  display  _position()  in- 

structions()  popup() 
redraw_figures() 
showpopup() 
set  screenQ 

edit_obj()  edit_menu()  alter  attributesQ 

fig  menu ()  copy_obj() 

mainjnenuQ  display_position() 

find_figure() 

get  bottom  () 

get  current  linestyleQ 

get  current  linewidth  ( ) 

getcurrent  texture() 

get  left  ()  getqueueQ  in- 

structions()  newcursor() 

redraw  _figures( ) 

set  current  textureQ 

set  current  linestyle() 

set  current  JinewidthQ 

setorthoviewQ 

set  writ  ten  Q 

updateboundsQ 

ellipse21ist()  file21ist()  insertellipseQ 

map  to  listQ 

ellipse  to file()  list2file()  mapQ 


Function 

Called  From 

Calls  To 

fig  menu() 

main  menuQ 

change() 

display  positionQ 
draw  a()  edit  obj()  in- 
structions()  popup() 

redraw  figures() 
showpopup() 
set  screen() 

file2list() 

get  from  file() 

arc21ist()  bad  data() 

circle21ist()  ellipse21ist() 
font21ist() 
get  current  font() 
get  current  linestyle() 
get  current  linewidth() 
get  current  texture() 
get  next() 
insert  into  list() 
line21ist()  linestyle21ist() 
linewidth21ist() 
p>olygon21ist()  seed2list() 
set  current  font() 
set  current  linestyleQ 
set  current  linewidth() 
set  current  textureQ 
syntax  error()  text21ist() 
texture21ist() 

find  figure() 

edit  obj() 

check  arc() 

check  cirde() 

check  correct() 

check  line()  check  text() 

instructions() 

font21ist() 

file21ist( ) 

insert  into  list() 
set  current  font() 

font  sizeQ 

binsert  into  list() 
btext21ist() 
changefont() 
draw  text() 
insert  into  list() 
modify  text() 
text21ist() 

index2ftable() 

font  to  file() 

list2fiic() 

none} 

Function 

Called  From 

fontsourceQ 

select  font() 

full  memory  () 

binsert  into  iist() 
bline21ist() 

bpoly21ist()  dupli- 

cate() 

insert  into  list() 
line21ist()  poly21ist() 

get  alignment() 

bmove  fileQ  copy- 

block()  copy_obj() 

init  guidesQ 
move  obj() 
move  page() 
move  picked  objs() 
restrict  mouse() 
set  orthoviewQ 
set  mouse{) 
set  screen  () 
update  bounds() 
view_page() 

get  angle  () 

draw  arc() 
draw  arrow  () 

get  blockQ 

blockedit()  draw  a() 

Calls  To 


instructions()  newcur- 
sor()  popupQ 

redraw_figures() 
set_screeii()  showpop- 
UP() 


get_queue() 

redraw_figures() 

set_orthoview() 


get_queue() 


display  position  ( ) 
get_bottom() 
get_current_linewidth() 
get_lfft()  get_queue()  in- 
structions()  lw2pix() 
red  raw  fi  gu  res  ( ) 
set_orthoview() 
updateboundsQ 


Function 


getcircleQ 


get  curren  t  _fon  t  ( ) 


Called  From 


bdraw_page()  block- 

edit()  bmove_file() 

copy_obj()  copy- 

block()  draw  aQ 

draw_arc() 

draw_arrow() 

draw_circle() 

draw_line() 

draw_page() 

draw_copy() 

draw_multi_lineQ 

draw_polygon() 

draw_rectangle() 

draw_smooth_Iine() 

draw_text()  editobjQ 

getblockQ  getcircleQ 

move_picked_objsQ 

moveobjQ 

notfoundQ 

restrict_mouse() 

setorthoviewQ 


Calls  To 


bfile21ist() 

binsertintolistQ 

btext21ist() 

drawtextQ  dulpi- 
cateQ  file21ist() 

insert  _into_list(} 
select_font() 
set  screenQ  text21ist() 


display  positionQ 
distancebetweenQ 
get_bottom()  get_left() 
getqueueQ  instruc- 
tionsQ  redraw  _figares() 
setorthoviewQ 
update  boundsQ 


Function 

Called  From 

Calls  To 

get  current  linestyleQ 

bfile21ist() 

binsert  into  list() 

binsert  seed() 

btext21ist() 

draw  arrow() 

draw  text()  dupli- 

cate()  file21ist() 

insert  into  list() 

insert  seed() 

modify  seed() 

set  screenQ  text21ist() 

[nonej 

get  current  linewidth() 

bfile21ist() 

binsert  into  listQ 

binsert  seed() 

btext2iist() 

draw  arrow  () 

draw  text()  dupli- 

cateQ  edit  obj() 

file21ist()  getblockQ 

insert  into  listQ 

insert  seedQ 

set  screenQ  text21ist() 

[none] 

get  current  texture() 

bfile21ist() 
binsert  into  listQ 
draw  arrowQ  dupli- 
cateQ  edit  objQ 

file21ist() 
insert  into  listQ 
insert  seedQ 
binsert  seedQ 
set  screenQ 

[pone] 

get  directory() 

read  menuQ 
write  menuQ 

dirdrawQ  dirscrollQ  get- 
listQ  get  queueQ  in- 
structionsQ 

>  . ' 
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Function 

CaUed  From 

Calls  To 

get  from  file() 

read  menu() 

drawing  existsQ 

get  queue()  file21ist()  in- 

structions() 

set  current  font() 

set  current  linestyleQ 

set  current  linewidth() 

set  current  texture() 

set  real  linewidth() 

set  filename() 

set  written  () 

get  left  () 

bdraw  page()  block- 
edit()  bmove  file() 

copy  obj()  copy- 

block()  draw  a() 

draw  arc() 
draw  arrow  () 
draw  circleQ 
draw  copy() 
draw  multi  line() 
draw  page() 
draw  polygon() 
draw  rectangleQ 
draw  smooth  line() 
edit  obj()  getblock() 
getcircle()  draw  line() 
move  obj() 
move  picked  objs() 
not  found  () 
restrict  mouse() 
replace  hdgl  w  dhg2() 
set  orthoviewQ 

[none] 

get  next  ( ) 

bfile21ist()  file21ist() 

[none] 

Function 


Called  From 


baddataQ 

bget_from_file()  block- 

edit()  bmovefile() 

check_correct() 

copy_obj()  copy- 

block  ()  draw_a() 

draw_arc() 

draw_arrow() 

draw_circle() 

draw_line() 

draw_multi_line() 

draw_polygon() 

draw_rectangle() 

draw_text()  edit_obj() 

full_memory() 

get  user _alignment() 

get  directory () 

get_circle() 

get_from_file()  get- 
block()  go_to_file()  in- 
valid()  move_obj() 
movepageQ 
move_picked_objs() 
not_found() 
select  font  Q 
select_lw()  sensible() 
syntax  _error() 
view_page() 


Calls  To 


Function 

CaUed  From 

get  real  linewidth() 

binsert  into  list() 
draw  arrow  () 
insert  into  list() 

get  user  alignment() 

main() 

go  to  file() 

wite  menu() 

gtlpt  inside() 

find  objects() 

index2ftable() 

alter  attributes() 
font  size() 
select  font() 
set  screen () 

init  attributesQ 

initialiseQ 

init  guides  () 

main() 

initpopup() 

main() 

insert  arc() 

arc21ist()  barc21ist() 

insert  arc() 

insert  diamond  () 

draw  a() 

insert  ellipse() 

draw  a() 

insert  hdgl() 

draw  text() 

Calls  To 


tnone 


get_queue()  inside() 
set_aiignment() 

get_queue()  instruc- 
tions()  list_to_file() 
setwrittenQ 

inside() 

changefont()  changetex- 
ta()  changelsQ 

changelw() 

index2ftable()  instruc- 
tions()  popup() 

select  font  () 
selecttextureQ 
select  ls()  select  lw() 
set  screen ()  showpop- 

up(l _ 

(none: 

get  alignmentQ 
insert  into  list() 

[none] 

insert_into_list() 

insert_into_list() 
insert  into  list() 

get_bottom()  get_left() 
insert  into _Iist() 


mstruc- 


Function 


insert  intolistQ 


insert  seed  () 


insert  _triangle( ) 


insideQ 


CaUed  From 


change()  changefontQ 
changels()  changelw() 
changetexta() 
draw_a() 
draw  _ar  row  () 
draw_circle() 
draw_line() 
draw_multi_line() 
draw_polygon() 
draw  _rectangle( ) 
draw_smoothline() 
draw_text()  dupli¬ 
cate  ()  file21ist() 

font_to_file() 
initguidesQ 
insert  _arc() 
insert  _d  iamond  ( ) 
insert_ellipse() 
insert  seed  () 
inserttriangleQ 
line_to_file() 
ls_to_file() 
lw_to_file() 
polytofileQ 
text_to_file() 
texture_to_file() 


seed2file() 


draw_a() 


get_user_alignment() 

gtlpt_inside() 

one_pt_inside() 

select_text() 


Calls  To 


ful*_memory() 
font  size() 
get_».urrent_font() 
get  cur  rent  _linesty  le  ( ) 
get_current_linewidth() 
get  real  _linewidth() 
get_current_texture() 
set_written() 


get  curren  t  linesty  le( ) 
get  current _linewidth() 
get_current_texture() 
insert  into  list() 


insert_into_list() 


Function 


in  valid  _en  t  ry  ( ) 


Called  From 


alter  attributesQ 

bget_from_file() 

blockeditQ  block- 

edit()  bmove_file() 

check_exit()  clear- 

page()  copyblock() 

copy_obj() 

check  _correct() 

draw_a()  drawarcQ 

draw_arrow() 

draw_circle() 

draw_line() 

draw  multi  line() 

draw_polygon() 

draw  _rectangle( ) 

draw  smooth  _line( ) 

draw_text() 

edit  _menu()  edit_obj() 

fig  menu  () 

findfigureQ 

fontsourceQ 

get  from_file() 

gotofileO 

get_directory()  get- 

block()  get_circle()  in- 

valid()  line_menu() 

main_menu() 

move_obj() 

move_page() 

move_picked_objects() 

not  found  () 

read_menu() 

select  _font() 

select_ls()  select  _lw() 

select _text()  sensible() 

set  screen  () 

view_page() 

write_menu() 


changels()  changelw() 
changetexta() 


Call*  To 


get_gueue()  instruc- 
tions()  redraw  fig u res () 
set  orthoview() 


Function 


Called  From 


Call*  To 


line21bt() 


file21ist() 


linemenuQ 


main  menu() 


full_memory() 

insert_into_list() 

map_to_list() 


changef) 

display  position  ( ) 
draw_a()  instructions() 
popup()  redraw_figures() 
showpopup() 


set_screen() 


line_aise() 


line_to_file() 


linestyle21ist() 


change()  duplicate() 


list2file() 


file21ist() 


map() 


insert_into_list() 

set_current_linestyle() 


linest  y le  _t o  file  ( ) 


linewidth21ist  ( ) 


list_to_file() 


file21ist() 


insert_into_list() 

lw2pix() 

set_current_linewidth() 

width21wnum() 


linewidt h  to  _file( ) 


lbt_to_file() 


list_to_file() 


arc_to_file() 

circle_to_file()  cleanupQ 

cleanlist() 

ellipse_to_file() 

fonttofile() 

line  to  file() 

linestyle_to_file() 

linewidth_to_file() 

poly  to  file() 

seed  to  file() 

textto  _file() 

texture  to  file() 


Function 


Called  From 


binsert_into_list() 

binsert_seed() 

blinewidth21ist() 

btext21ist()  changeQ 

changefont() 

changelw() 

draw_arrow() 

draw_text()  dupli- 

cate()  getblock() 

insert_into_list() 

insert_seed() 

linewidth21ist() 

modify  seed  () 

modify  _text() 

move_obj()  text21ist() 


Activated  from  the 
illustrator  system  call 
NPSDRAW 


Calls  To 


cleanupQ 

get  user  alignment () 
init_guides()  initialise() 
initpopup  main_menu() 
opening_display()  read- 
fonttableQ 


block_edit()  change() 

check_exit()  clearpage() 

display  _position() 

draw_a()  edit  obj() 

edit_menu()  fig  menu() 

instructions() 

line_menu()  popup() 

read  menu () 

redraw  figures() 

set_screen() 

set  orthoview() 

showpopup() 

togglegridQ 

view_page() 

write  menu() 


Function 

Called  From 

map() 

arc  to  file( ) 
circle  to  file() 
ellipse  to  file( ) 
line  to  file() 
poly  to  fileQ 
seed2file() 
text  to  file() 

Call*  To 


map_to_li*t() 


modify  arc() 


modify  circle( ) 


modify  ellipse  ( ) 


modify  _line() 


modify  _obj  ect  ( ) 


modify  polygon  ( ) 
modify  seed  () 


modify  text  () 


moveobjQ 


move  page() 


arc21ist()  barc21ist() 

bcircle21ist() 

bellipse2list() 

bHne21ist() 

bpolygon21ist() 

bseed21ist() 

btext21ist() 

circle21ist() 

ellipse21ist()  line21ist() 
polygon21ist() 
seed21ist()  text21ist() 


modify  _onject() 


modify  _object() 


modifyobjectQ 


modify  objectQ 


bmove_file()  dulpi- 
cate()  move_page() 
movepicked  _objs() 
move_obj() 


modify  objectQ 
modify  object() 


modify  objectQ 


edit  obj() 


edit  menuQ 


modify  arc  () 
modify  circleQ 
modify  ellipseQ 
modify  JineQ 
modify  seed () 
modify  textQ 
modify  polygonQ 


none 

get  current  linestyle() 


none 


getleftQ  get  bottomQ 
get  queueQ  instruc- 
tionsQ  modify  object() 
set  orthoviewQ 
updateboundsQ 


get_aiignment() 
get  queueQ  instruc- 
tions()  modify  objectQ 
set  written!) 


$ 


Function 

Called  From 

Calls  To 

move  picked  objs() 

blockeditQ 

display  positionQ 
draw  pageQ 
get  alignmentQ 
get  bottomQ  get  leftQ 
get  queueQ  instruc- 

tionsQ  modify  objectQ 
set  orthoviewQ 
set  writtenQ 
update  boundsQ 

newcursor  ( ) 

bblockedit()  block- 

edit()  check  exit() 

clearpage()  draw  a() 
edit  obj()  fontsource() 
opening  display  ()  pop- 
up()  read  menu() 

select  font() 
select  ls()  select  lw() 
select  textQ  showpop- 
up()  write  menuQ 

[none] 

not  found  () 

blockeditQ 
find  figureQ 

display  positionQ 
get  bottomQ  get  leftQ 
get  queueQ  instruc- 

tionsQ  set  orthoviewQ 

not  senaibleQ 

changefontQ 
changelsQ  changelwQ 

get  queueQ  instruc- 

tionsQ  redraw  figuresQ 
set  orthoviewQ 

one  pt  inside() 

find  objectsQ 

insideQ 

opening  display () 

mainQ 

newcursorQ 

poly  to  file() 

list  to  fileQ 

mapQ 

Function 

Called  From 

Calls  To 

Popup() 

alter  attributes() 

check  exit()  clear- 

page()  edit_menu() 

fig  menu() 

fontsource() 

line  menu() 

main  menuQ 

read  menu() 

select  font() 

select  ls()  select  lw() 

write  menu)) 

none] 

printable)) 

draw  text() 

none] 

read  menu() 

main  menu() 

get  directory  () 
get  from  file()  instruc- 
tions()  newcursor()  pop- 
up()  redraw  figures)) 

set  orthoview() 
set  screen))  show  pop¬ 

up)) 

readfontable)) 

main() 

1 none  ] 

Function 


redraw  _figures() 


remove  last  () 


replace  hdgl  _whdg2( ) 


reprod  uce  last  ( ) 


reset  mouse  () 


restrict  _mouse( ) 


seed_to_file() 


seed21ist() 


select  text  () 


Called  From 


baddataQ  blockedit() 

check_correct()  clear- 

page()  draw_a() 

drawarcQ 

draw  arrow  () 

drawcircleQ 

draw_line() 

draw_multi_line() 

draw_polygon() 

draw_rectangle() 

draw_smooth_line() 

draw_text() 

edit_menu()  edit  obj() 

fig_menu() 

fontsource() 

full  memory ()  get- 

block()  get_circle()  in- 

valid()  line_menu() 

main_menu() 

read_menu() 

select_font()  sensible() 

set  screen  () 

view_  age() 

write  menu() 


draw_a()  draw_text() 


draw_text() 


draw_a() 


draw  _line() 
select  lw() 


draw_line() 


list_to_file() 


file21ist() 


alter  attributes(} 
change() 


Calls  To 


getbottom()  get_left() 

insert_into_list() 

remove_last() 


[none] 


get  alignment () 


get_alignment() 
get_left()  get  bottomQ 


map() 


insert  seed() 
map  to  list() 


inside()  instructions() 
newcursor() 


Function 

Called  From 

Calls  To 

select  font() 

alter  attributesQ 
change() 

fontsourceQ 
get  current  fontQ 
get  queueQ 

index2ftable()  instruc- 

tionsQ  newcursorQ  pop- 
upQ  redraw  figuresQ 

set  screen ()  showpop- 

“P() 

select  ls() 

alter  attributesQ 
changeQ 

instructionsQ  newcur¬ 

sorQ  popupQ  showpop- 
«P() 

select  lw() 

alter  attributesQ 
changeQ 

get  queueQ  instruc¬ 

tionsQ  newcursorQ  pop- 
upQ  showpopupQ 

varlwQ 

set  alignment() 

get  user  alignmentQ 

[none] 

set  bottom() 

set  screen  () 

[none] 

set  current  font() 

bfile21ist()  bfont2list() 
changeQ  clearpageQ 
duplicateQ  file21ist() 
font21ist() 
get  from  fileQ 

set  screen () 

set  current  linestyle() 

bfile21ist() 

bget  from  fileQ 
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